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CHAPTER 1 

INTRODUCTION TO RTOS 

The Real Time Operating System (RTOS) for the DGC family computers consists 
primarily of a small, general purpose multi-task monitor designed to control a 
wide variety of real time input/output devices, RTOS is entirely core -resident, 
highly modular and largely reentrant, and allows for the straightforward addition 
of special device handlers. Moreover, RTOS, revision 4 . 00 is a compatible subset 
of RDOS revision 4. 00, Data General's Real Time Disk Operating System. 

User programs are relieved from die details of I/O timing, data buffering, 
priority handling, and task scheduling. In addition, users are provided with a 
parallel processing capability plus inter-task communication and synchronization 
facilities. Communication with the RTOS monitor takes place through a small 
set of RTOS system and task calls. 

A task is the basic logical unit controlled by RTOS. Tasks are created by means of 
one of the RTOS task calls, and having been created, a task may be terminated 
at any time. A large number of common processing situations lend themselves 
admirably to this sort of operational control philosophy. Examples of these 
processing situations include the reading or writing of a block of data while simul- 
taneously performing arithmetic computations, listening for input from several 
devices at the same time, shared device use by multiple tasks, sophisticated 
communications problems, etc. 

RTOS TASK CONCEPTS 

A task is a logically complete, asynchronous locus of control through a program. 
A task demands use of system resources (including CPU control). Many tasks 
may be assigned to operate asynchronously in a single reentrant sequence of 
instructions, and each task may be assigned a unique priority and identification 
number. 

Due to the serial nature of a computer, tasks which appear to be executing their 
operations in parallel are in actuality executing these operations in short, serial 
segments. It is necessary then for RTOS to maintain certain status information 
(primarily active registers) concerning all tasks which are not currently in control 
of die Central Processing Unit (CPU). 

This information is retained in an information structure called the Task Control 
Block (TCB). The maximum number of TCBs is defined at the time of system 
generation. 
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Task States 

Tasks may exist in any of four states. Tasks are either ready to perform their 
functions, they are actually in control of the CPU and are executing their assigned 
instruction paths, they are suspended and temporarily unable to receive CPU 
control, or they are dormant, having no priority and no chance of gaining CPU 
control until activated by a .TASK or . QTSK command. The Task Scheduler always 
gives CPU control to the highest priority task that is ready. 

Suspended tasks are tasks which were once ready, A task may become suspended 
for one or more of the following reasons: 

1. It has been suspended by . SUSP, . ASUSP, or .TIDS. 

2. It has suspended itself for a specified period by . DELAY. 

3. It is waiting for a message from another task, . REC. 

4. It has issued a mess age -and -wait call, . XMTW. 

5. It Is awaiting the completion of a . SYSTM call. 

Just as a number of different events may suspend a ready task, several events can 
cause a suspended task to be readied: 

1. The completion of a . SYSTM call (such as a request for I/O or the 

expiration of a time delay). 

2. The posting of a message for a suspended task awaiting its receipt, 
or the awaited receipt of a transmitted message, 

3. The readying of a task by . ARDY or .TIDR task calls. 

If a task is suspended by both a task suspend call and by some other event, the 
call must be readied both by an . ARDY (or . TIDR) call and by whatever other 
event is required to ready the task. 

Suspended and ready tasks are each connected in queues. Tasks may be deleted 
from either the ready or the suspended queues, either separately (. ABORT or 
, TIDK) or as a priority class (. AKILL). Tasks which have been deleted add their 
empty TCBs to an inactive chain of free TCBs. When a task Is initiated (.TASK), a 
TCB is taken from the free chain, the state of the calling task is saved in its own 
TCB, and both tasks are entered into the ready queue as ready tasks. The .TASK 
command must be used to initiate a multitask environment. 

If all tasks are killed, the effect Is to place the entire system in the idle state 
and to close all channels, with control passing to the task scheduler. The system 

remains capable of servicing interrupts. 
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Task Identification Numbers 

When a task is created, it may be created both with a unique identification number 
(I. D. ) from 1 to 377 g and at a specified priority level (from to 377 ). The 
identification number allows tasks to be readied, suspended, or killed on a 
selective basis. If unique I. D. *s are not desired, tasks may all be created with 
I. D. 's of 0. Tasks may exist at priority levels of (the highest) through 377 
(the lowest priority). Moreover, several or all tasks may exist at the same 8 
priority level. The task scheduler always allocates CPU control to the highest 
priority ready task; ready tasks within the same priority level receive CPU control 
on a round-robin basis. 

Task Synchronization and Communicatio n 

RTOS permits tasks to communicate with one another by sending and receiving 
one-word non-zero messages. A one-word message is sent to a task in an agreed- 
upon location in user address space. User address space is understood to include 
all locations from address 16 through NMAX inclusively. 

The task sending a message may either return to the Task Scheduler immediately 
(. XMT) or it may wait (. XMTW) and place itself in the suspended state until the 
receiving task has issued a receive request (. REC) and has received the message. 
Receipt of the message includes the resetting of the contents of the message address 
to all zeroes. Upon receipt of the message, the recipient reverts to the ready 
state. 

System and Task Call Formats 

Calls to the RTOS monitor can be separated into two categories: system calls 
and task calls. System calls generally perform system I/O. Task calls perform 
user task management functions. 

System command words and the mnemonic . SYSTM that must precede each command 
word are recognized as legal mnemonics by both the RDOS and stand-alone extended 
assemblers. Appearance of the mnemonic . SYSTM in a program results in the 
assembling of a JSR § 17 instruction. The specific system command word is assem- 
bled as the word following the mnemonic . SYSTM. 

Once system action is complete and the task receives CPU control in priority fashion, 
normal return is made to the second instruction after the system command word. If 
an exceptional condition Is detected, return is made to the first Instruction following 
the system command word. 
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System and Task Call Formats (Continued) 

The general form of a system call description is: 

AC - required input to the call 
n 

» SYSTM 

command 

error return (error code in AC2) 

normal return ( all AG's except ACS are restored unless output 

is returned via accumulator) 

AC " output from the call 
n 

There are 2 basic command word formats: 

command n and command 

where n is a number from to 76 g representing an I/O channel number. The 
maximum number of channels, like the maximum number of tasks, is defined at 
the time of system generation. Any system command requiring a channel number 
n need not specify this number in the command word. Instead, by specifying n 
to be octal 77, the system will use the number passed in AC2 as the channel 
number. 

When no I/O is needed in command execution, the command word appears alone in 
the instruction. If the command requires arguments, these are passed in the 
accumulators. 

AC2 is used when an exceptional return is made to return a numeric error code. 
Error codes are listed by number in the RTOS parameter listing, and the applicable 

codes are listed for each command. 
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Status of the accumulators upon return from the system (. SYSTM or task call) is 
as follows. If the system returns no information as a result of the call, the carry 
and all accumulators except AC3 will be preserved. AC2 is used when an excep-' 
tional return is made to return a numeric error code. Error codes are listed 
in Appendix A. 

AC3 is destroyed by a , SYSTM or task call (as it is by the use of "JSR"). On 
return from NOVA®* RTOS systems however, AC3 is loaded with the contents of 
memory location 000016. This location is defined as a permanent symbol by the 
assemblers and has the name USP (User Stack Pointer). A convenient method of 
saving AC3 in such systems is to store it in USP before issuing the . SYSTM or 
task call. The system will load AC3 with the contents of USP upon return from 
the call in NOVA RTOS systems. 

Single task ECLIPSE™* RTOS programs loaded with TMiN also load USP into 
AC3. Programs loaded with BTMIN, however, load FP (the frame pointer) into 
AC3; all multitask programs run on ECLIPSE systems do this also. BTMIN must 
be loaded explicitly before the RTOS system libraries are scanned in order for 
BTMIN- -instead of TMIN --to be included within a single task ECLIPSE program. 
In any case, the contents of USP wall be restored to its former state in all systems. 

Users with programs which assume that USP is contained in AC3 after system and 
task calls can run these same programs when the system loads FP, not USP, into 
AC3. This can be accomplished by creating a parameter file with the entry 
".DUSR USP = 41". This file must be scanned at assembly time after, not before, 
the regular user parameter file, PARU. 

Users of task calls are cautioned to reference all task call commands whose 
operations are required within a program by their call names in an . EXTN 
statement in that program. Only those calls which are so referenced will have the 
appropriate task call processing modules loaded by the relocatable loader. 

The general form of a task call in a program is: 

AC - required input to the call 

n 

command 

error return (error code in AC2) 

normal return ( all AG's except AC3 are restored unless output 
is returned via accumulators) 

AC - output from the call 
n 



: NOVA is a registered trademark, and ECLIPSE is a trademark of Data General 
Corporation, Southboro, Massachusetts. 
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System and Task Call Formats (Continued) 

The significant differences between a , SYSTM call and a task call are as follows: 

1, Task calls are not preceded by the . SYSTM mnemonic. 

2. Not all task calls have error returns. T"«so which dc not 
have an error return do not reserve an error return location, 
All system calls reserve error return locations even if there 
is no error return possible, 

)£YICE SUPPORT UNDER RTOS 

I/O devices are given special reserved names which often begin with the character 
$. The following list gives the names of devices supported under RTOS and their 
reserved names: 

$CDR - Card reader. 

$CDR1 - Second card reader. 

CTn - Data General cassette unit n (n can be from to 7). 

DKO - Data General fixed head NOVADISC® *. 

DPn - Moving head disk, unit n (n can be from to 3). 

SLFT - 80- or 132 -column line printer. 

SLPT1 - Second line printer, 80 or 132 columns. 

MCAR - Multiprocessor Communications Adapter Receiver. 

MCAT - Multiprocessor Communications Adapter Transmitter. 

MTn - 7- or 9-track magnetic tape transport (n can be from 
0to7). 

$PLT - Incremental plotter. 

$PLT1 - Second incremental plotter. 

$PTP - Paper tape punch. 

$PTP1 - Second paper tape punch. 

$PTR - High-speed paper tape reader. 

$PTRi - Second paper tape reader. 

QTY - 4060 asynchronous data communications multiplexer. 

$TTI - Teletype® *%r video display terminal keyboard. *** 

$TTI1 - Second Teletype or display terminal keyboard. *** 

$TTI2 - Third Teletype or display terminal keyboard.*** 

$TTO - Teletype printer or display terminal screen. 

$TT01 - Second printer or display terminal screen. 

$TT02 - Third printer or display terminal screen. 



*NOVADISC is a registered trademark of Data General Corporation, Southboro, 

Massachusetts. 

* Teletype is a registered trademark of Teletype Corporation, Skokie, Illinois. 

***If the Teletype reader is turned on for line reads, data read will be echoed on 
the Teletype printer. 
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MAGNETIC AND CASSETTE TAPE FILES 

RTOS provides two means for accessing data on magnetic tape and cassettes: Tape 
file I/O and direct or free format I/O, 

Tape file I/O is implemented in both line and sequential I/O modes. Tape file 
I/O is buffered by the system, whereas direct I/O is unbuffered by the system, 
RTOS will support up to 16 magnetic and 16 cassette tape drives. Magnetic tape 
units can be in any combination of 7- and 9 -track units, with reading and writing 
at any density supported by the controller for direct I/O; other forms of I/O require 
high density. 

If the controller detects a parity error during reading, the system will attempt 
to reread the data ten times before issuing error code ERFIL, "file data error. " 
If an error is detected after writing, the system will attempt, up to 10 times, to 
backspace, erase, and re -write. If the re -write is unsuccessful after the tenth 
time, then an error will be signaled. 

Seven -and Nine Track Data Words 

Data recorded on 7 -track units is necessarily encoded. Every data word, written 
on 7 -track units in tape file I/O, is encoded as two data words, four successive 
frames. Data words written to 7 -track units In free format I/O is encoded as two 
successive frames. Data words output to 9-track units, under both file I/O and 
free format I/O, Is written as two successive eight -bit bytes. Data encoding is 
accomplished on 7 and 9-track units in the following manner. 

101 11 







Original Data Word 

7-track encoding 
parity data 

(frame 1 x x x 1 



5 6 7 8 9 



12 13 i 14! 15| 



2 3 



File I/O 



frame 2 x xx4 5 67 



9-track encoding 
parity data 

x 1 2 3 4 5 



6 7 



9 10 11 12 13 14 15 



Iframe 3 x x x 



9 10 11 



frame 4 x x x 12 13 14 15 



Free Fnrm( f rame 1 x 2 3 4 5 6 7 
I/O j f rame 2 x 10 11 12 13 14 15 



12 3 4 5 6 7 
8 9 10 11 12 13 14 15 
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Cassette and Magnetic 
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[les have the same format. Data is written and read 
1 6 -bit words. Data files are variable in length, each 
length blocks as is required, The first 255 words 
"» and the last two words each contain the file number 
ws the structure of a data block: 



Data words 



File number 



File number 



255 words 

1 word 
1 word 



After the first file, an end -of -file (EOF) mark is written. EOF marks separate 
each succeeding file, and two EOF marks are written after the last file. Files 
are written in consecutive order, starting with file number and extending through 
file number 99. 

] - hhilir irw .ivd RcL.-a smr i T.;re DDvy 

Before any tape files on a tape drive can be accessed the drive must be initialized 
via the . INIT system call. Initializing a tape drive causes the tape on that drive 
to be rewound. Full initialization causes the tape to be rewound and two EOFs to 
be written (effectively erasing all files from the tape). In both cases, the tape 
file pointer maintained by RTOS is reset to 0. A full initialization of all new (blank) 
tapes should be performed before using them. 

Referencing Files on Cassette and Magnetic Tape 

Files are placed on tape in numeric order, beginning with file number 0. Up to 
100 files may be placed on any given tape. The last permissible file is file number 
99. 



A given file is referenced in a command by a tape global specifier followed by a 
colon and file number. Global specifiers for the cassette and magnetic tape are: 



MTn:m 



Magnetic tape unit n attached to the first controller, 
where n is from 0-7 and has no leading zero, with file 
number m from 0-99. 
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Referencing Files on Cassette and Magnetic Tape (Continued) 

MTlnrm Magnetic tape unit n attached to the second controller, 

where n is from 0-7 and has no leading zero, with file 
number m from 0-99. 



CTn:m 



Cassette unit n attached to the first controller, where 
n is from 0-7 and has no leading zero, with file 
■ww'w.'- " : - ,'r >.-\ < :-^-?. 



CTln:m Cassette unit n attached to the second controller, where 

n is from 0-7 and has no leading zero, with file number 
m from 0-99. 

Either a one -digit or a two-digit number may be used to reference the first ten 
file numbers. Thus to reference file number 8 on cassette or magnetic tape unit 
2 attached to the first controller, the following global specifiers would be used: 



MT2:08 



or 



MT2:8 



CT2:08 



or 



CT2:8 



Both the tape global specifier and the file number must be given. Violation of this 
rule will cause the system to return error code ERFNM, "illegal file name. " 

Some examples of references to files on tape are: 



WRITE; 



LDA 0, MTAPE 
SUB 1, 1 
. SYSTM 
. INIT 

JMP ERROR 
SUB 1,1 
LDA 0, FILNM 
. SYSTM 
.OPEN 1 
JMP ERROR 
LDA 0, BUF 
. SYSTM 
.WRL 1 
JMP ERROR 



;GET UNIT NAME 

; PARTIAL INITIALIZATION 

INITIALIZE UNIT MT0 

RECOVER FROM SYSTEM ERROR CONDITION 
PRESERVE DEVICE CHARACTERISTICS 
GET TAPE UNIT NAME 

OPEN MT0 FILE 1 ON CHANNEL 1 
ERROR UPON SYSTEM CALL 
GET BUFFER POINTER 

; WRITE LINE TO FILE 1 OF MT0 

;RECOVER FROM SYSTEM ERROR CONDITION 



(see next page) 
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Referencing Files on Cassette and Magnetic Tape (Continued) 

F1LENM: " . *2+l 

,TXT *MT0:1* 
MTAPE: , *2+l 

,TXT *MT0* 
BUF: , *2+l 

.BLK 132, 
. END 

Writing Files on Tape 

Files must be placed on cassette and magnetic tape in numeric order. For example, 
suppose the user transfers a file, FILED, to tape unit 3 which has just been 
initialized, FILED will be the first file on the tape. The tape on drive will now 
contain the following: 



First file, containing the con- 
tents of FILEO. 



Once a file is written, the file 
number of the next file is 
assigned. File 1 is a null file, 



An attempt to place a new file on this tape at file position 2 where only FILEO has 
been written on the tape, will result in error ERDLE being signaled, "file does 
not exist". 

It is possible to overwrite a magnetic tape file. For example, assume a tape on 
drive contains four files: 
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Writing Files on Tape (Continued) 



Null file. 



A command to write FILEO to file 1 will cause the contents of that file to overwrite 
the tape beginning at the file 1 position. When a tape is written in this manner, all 
subsequent files on tape are lost. In the example, the tape will contain: 



eof 



eof 
eof 



Original file zero 



FILE 



Null file or inaccessible 
data 



Users are cautioned to do either an . INIT or .RLSE of the tape transport before 
removing either a cassette or magnetic tape reel. Issuance of these commands 
resets the system tape file pointer to so that accessing of rewound tape files can 
be accomplished correctly, and reassigns the default global specifier name as 
required. 
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Writing Files on Tape (Continued) 



Users must also note the implications of the logical end -of -tape mark, double 
w co- ? employed by RTOS. If, by mistake, an attempt is made to access serially 
two files beyond the logical end -of -tape mark, the tape transport will be placed 
in a runaway condition. This error is illustrated by the following command 
sequence. 



Full . INIT of MTO 



OPEN and . RDL of 
MT0:0 



OPEN and . RDL of 
MTO: 2 



User places a null file on tape, terminated by 
the logical end -of -tape mark, EOF EOF. 

The system reads null data found between the 
double EOF characters, and stops at the second 
EOF. 

The system transport is placed in a runaway 
condition as the system searches in vain for an 
EOF mark. 



A corollary error occurs when an attempt is made to write a null file between data 
files on tape. The following command sequence illustrates this problem: 



. OPEN MT0:0, . WRL file A 
.OPEN MT0:1, .WRL file B 
. OPEN MT0:2, . WRL file A 
. RLSE and . INIT MTO 



Data file A is written to file 0. 
Null file B is written to file 1. 

Data file A is written to file 2. 

Transport is released and initialized to reset 
the tape file pointer to 0. 



The file arrangement produced on MTO looks like the following: 





eof 
eof 

2 

eof 

eof 



file 


A 


null 


file 


file 


A 




. 
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Writing Files on Tape (Continued) 

An attempt to read file 2 will cause error ERDLE, "file does not exist, " to be 
signaled since the system interprets the double EOF mark to be a logical end -of - 
tape marker. 



FREE FORMAT I/O 

Data is read and written on magnetic and cassette tape in free format. Data 
records may be of varying length, containing from 2 to 4096 16-bit words each, 
and with 1 or more records per file. Each tape reel can contain as many files as 
the reel size will permit, although only the first 100 files can be positioned 
directly when a file is opened. 

Before any free format I/O can occur on a device, that device must first be initialized 
and then opened for this type of I/O. The system call . MTOPD is issued to open 
either mag tape or cassettes for free format I/O. When a tape unit is opened, it is 
positioned to a specified file, and the unit is associated with an RTOS channel. Thus, 
even though the unit has positioned a tape reel to a specific file, all files on the 
tape can then be accessed via space forward/space backward commands, and all 
records within each file can be similarly accessed. 

ASYNCHRONOUS DATA COMMUNICATIONS MULTIPLEXER (QTY) 

The type 4060 asynchronous data communications multiplexor is another device 
supported by RTOS. RTOS assigns the system mnemonic QTY to this device. 
The QTY can accommodate from 1 to 64 full or half duplex lines, in either half or 
full duplex operation. 

Each multiplexed line of the QTY corresponds to a file name of the form 
QTY: xx 

where xx is a multiplexor line number in the range 0-64 decimal. Input/output 
operations are performed on each line by RTOS line or sequential read and 
write commands. 

Each single QTY line may be opened on a single RTOS channel only. No more than 

one read or one write request can be outstanding on any one line. 
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ASYNCHRONOUS DATA COMMUNICATIONS MULTIPLEXER (QTY) Continued) 

RTOS provides a facility for monitoring line activity on ail unopened QTY lines. 
If line number 64, QTY:64» is opened and either a read line or read sequential 
operation is attempted, the task issuing this call will be suspended until such 
time as an unopened line receives an interrupt request. When this occurs, the 
normal return of the read sequential or read line call will be taken, and AC2 
will contain the following data word: 



1 1 1 1 Line # IChar. 



12 7 8 15 



Thus this data word describes the line providing the character, and contains the 
character itself in its right byte. 

If two unopened lines receive an interrupt, only the first one to receive the 
interrupt will be reported. There will be no report of other unopened interrupting 
lines occurring before the next read line or read sequential on QTY:64 is issued. 

DISK FILES 



RTOS extends support to both fixed and moving head disk units. RTOS supports 
a fixed head NO VADISC controller with up to eight logical units of 128K, 25 6K, 

512K or 756K storage words; total fixed head storage per controller is from 131 
thousand to 2 million words. Up to four moving head disk devices (disk pack or 
cartridge type) can also be included in any system, with from 2 to 20 surfaces 
per unit; maximum total moving head disk storage is 49.2 million words. 

Disk files are defined at the time of system generation. At this time, file sizes 
are specified and names are assigned to each file. File names consist of from 
4 to 6 ASCII characters followed by a trailing null. Allowable ASCII characters in 
the file name are all upper case alphabetic characters and numerals through 9. 
A file must be opened (i. e. , associated with an RTOS channel) before it can be 
accessed. 

Disk File Organization 

Disk files in RTOS may be organized contiguously only. Contiguously organized 
files consist of a fixed number of one or more disk blocks located at an unbroken 
series of disk block addresses. These files can be neither expanded nor reduced 
in size. Since the data blocks are at sequential logical block addresses, all that 
is needed to access a block within a contiguous file is the address of the first 
block and the relative block number within the file. 
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Disk File Organization (Continued) 

File ABGD 

Block Address N Block Address N4-1 



all 256 

words are 
utilized 
for data 
storage ( 



r 



V 



Block Address N+2 



Relative Block No. 



Relative Block No. 1 



Relative Block No. 2 



Contiguously organized files have the advantage of allowing quick access to their data 
blocks, with all disk storage being used for data. 

RTOS/RDOS COMPATIBILITY 

The design intent of RTOS is to make this operating system a compatible subset 
of RDOS, the DGC Real Time Disk Operating System. Accordingly, all file 
structures, task concepts, system and task calls, and other features discussed for 
RTOS may be tested and run on an RDOS system. RDOS features omitted from 
RTOS were omitted because they could not be applied in RTOS, given the constraints 
of a quick responding core -resident -only operating system. 

Tape and Disk File Structures 

Cassette and magnetic tape file structures under RTOS are identical to those pro- 
vided by free format I/O under RDOS. 

Disk files in RTOS must be organized contiguously; sequentially and randomly 
organized disk files are available only under RDOS. Names are assigned to RTOS 
disk files at RTOSGEN time. Allowable ASCII characters in RTOS file names are 
all upper case alphabetics and numerals through 9. Unlike RDOS, however, disk 
file names must be 4 to 6 characters in length, may not include the $ character, 
and can have no file name extensions; file names defined at RTOSGEN time cannot 
be changed. Disk files must be opened before they may be accessed. 

Task and System Calls 

Unless otherwise specified, all RTOS system and task calls operate as they do under 
RDOS. Any attempt to reference a task call under RTOS which is not found in its 
library will cause an unresolved external to be reported by the loader. 
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In most cases, an attempt to execute an RDOS system call which is not implemented 
in RTOS results in an error return being taken with error code 2, ERICM (illegal 
system command), reported in AC2. However, some calls are treated as no-ops 
by RTOS to achieve downward compatibility (from RDOS to RTOS). The following- 
list names all of these calls which cause control to go directly to the normal return 
with no further action: 



. SYSI SOS- compatible call. 

.SPKL Kill spooling. 

,SPDA Disable spooling. 

. SPEA Enable spooling. 



Note that these calls will not operate correctly under RTOS in the presence of 
error conditions. Thus, for example, an attempt to delete a non-existent file would 
take the error return for . DELET under RDOS, but would take this call's normal 
return under RTOS. 

Channel/Task Specification 

The number of channels and tasks in a program run under RTOS is defined at 
RTOSGEN time. RTOS programs being tested under RDOS may specify channels 
and tasks by means of the RLDR local switches /C and /K, or by die .COMM TASK 
(or CHANT ASK) statements. 

RTOS Program Development Under RDOS 

Bearing in mind the above restrictions, RTOS program development under an RDOS 
system is convenient. RTOS programs are edited, assembled, loaded and debugg*ed 
under RDOS, and when they are considered to be error free they are reloaded with 
an RTOS module (produced by RTOS SYSGEN) and die RTOS library, using the RDOS 
RLDR command with the /C global switch. This load procedure creates a version of 
the program (called a save file) which can be run under RTOS. 

Having created this save file, one of several bootstrap procedures are followed to 
execute the program, depending upon whether the RTOS program is to be run on the 
system which is currently executing under RDOS or whether it is to be run under 
another system, with or without disk, which is not running under RDOS. 
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RTQS Program Development Under RDOS (Continued) 

Complete details describing the use of the RDOS RLDR command, operation of 
TBOOT, CBOOT, HIPBOOT, and procedures for relocatable loading of an RTOS 

program module on a stand-alone system are outlined in Appendix B of this manual. 

Avoiding Global Symbol Conflicts under RTOS 

hi order to minimize the incidence of global symbol conflicts between user pro- 
grams and RTOS subprograms, RTOS generally follows die convention of using a dot 
as the first character in each symbol. Thus user -defined global symbols should 
always avoid the use of a dot as the first character in a symbol. 

This rule has several exceptions which users should be aware of, i.e. , several 
global symbols in RTOS are not preceded by dots. These undotted global symbols 
are as follows: FWRIS, RTCIS, DCT names (summarized at the end of system 
o-pnpra tinns), entries in the buffer package (BFPKG), entries in Fortran libraries 
l-kjl\ l . -uo mid RTOS FMT. LB, and user high priority interrupt handlers. 

Generating Console Interrupts 

RTOS does not permit the generation of console interrupts (CTRL A, CTRL C, or 
CTRL F) which are available under RDOS. Nonetheless, RTOS does provide a 
facility which resembles an RDOS keyboard interrupt. This facility is the keyboard 
character wait command, .WCHAR . This command, discussed fully in Chapter 2. 
activates logic within RTOS such that when a user-specified character is received 
from any console keyboard, control will branch to a user -specified routine for 
appropriate processing. 

Inter -revision Source Level Incompatibilities 

Users of RTOS 3. 00 who wish to be upgraded to RTOS 4. 00, the current revision, 
should be aware of certain source level incompatibilities between the two revisions. 
A summary of these considerations is given in Appendix E. 
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CHAPTER 2 

SYSTEM CALLS 

The following page contains an alphabetized list of all RTOS system command word 
mnemonics. 

All system calls except user interrupt calls will be discussed in this chapter, with 
calls being grouped in the following sections: 

File and Input/Output Commands 
Teletypewriter /Video Display Commands 
Memory Size Commands 
System Return Commands 

Clock and Calendar Commands 
FILE AND INPUT/OUTPUT COMMANDS 



All I/O is handled by system I/O commands. These commands require a channel 
number from to 77 to be given in the argument field of the command word as 
discussed in Chapter 1. The number of channels available is determined by the 
user when the RTOS module is generated by the user (see Appendix B). 

The user may also define a number of fixed length files when the RTOS module 
is generated, and may assign alphanumeric names to these files. Such files 
are organized contiguously, and are composed of a fixed number of disk blocks 
which are located at an unbroken series of physical block addresses. These 
files can neither be expanded nor reduced in size. Since the data blocks are in 
sequence, all that is needed to access a block within a contiguous file is the 
name of the file (indicating to RTOS the address of the first block) and the relative 
block number within the file. Since no time is required for reading a file index, 
disk files under RTOS can be accessed rapidly. 
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System Call List 

.APPEND Append to a device. 

, CLOSE Close a file or device. 

.DELAY Suspend a task for a specific interval of time, 

. DUCLK Define a user clock. 

. ERTN Idle the system abnormally. 

, GCHAR Get a character. 

. GCHN Get a free channel number. 

, GDAY Get today's date. 

. GHRZ Get the real time clock frequency. 

. GMCA Get the current CPU's MCA number. 

. GTOD Get the time of day. 

. IDEF Identify a user interrupt device. 

. INIT Initialize a magnetic tape or cassette. 

. IRMV Remove a user interrupt device. 

, MEM Determine available memory. 

, MEMI Change NMAX. 

, MTDIO Perform free format I/O on magnetic tape or cassette. 

, MTOPD Open a magnetic tape or cassette for free format I/O. 

, OPEN Open a file or device other than the magnetic tape or cassette. 

, PCHAR Output a character to die teletypewriter. 

, RDB Read a disk block. 

,RDL Read a line. 

, RDS Read sequential bytes. 

.RESET Close all devices and files. 

, RLSE Release a magnetic tape or cassette unit. 

, RTN Idle the system normally. 

, RUCLK Remove a user clock. 

,SDAY Set today's date. 

, STOD Set the time of day. 

.WCHAR Wait for a character on a teletype. 

,WRB Write a disk block. 

WRL Write a line. 

,WRS Write sequential bytes. 
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HIJ« VO r:r:^ T- t ,-TP».'T COMMANDS (Continued) 

A channel is initially linked to a particular file or device by means of the . OPEN 
(or . APPEND) command. A channel is linked to a magnetic tape transport or 
cassette unit by means of the . MTOPD command only. The association between 
file or device and channel number is broken by using the . CLOSE command. All 
currently open files and devices can be closed, and their associated channels 
freed, by means of the system . RESET command. 

RTOS provides four different I/O modes for reading and writing. These modes 
are: 

direct block 

line 

sequential 

free format tape I/O 

In direct block mode, the user effects a transfer of a continuous group of disk 
blocks. Core locations used in the transfer are also in sequence. The direct block 
mode commands are . RDB and . WRB, read a block series and write a block series. 
This mode is used only with disk I/O, and no other I/O mode is used for disk I/O 
under RTOS. 

Line mode data transfers assume that the data read or written consists of ASCII 
character strings terminated by either carriage returns, form feeds, or nulls. 
Position within a file is implicit from the last call. That is, file data is processed 
line by line in sequence from the beginning of the file to its end. In this mode the 
system handles all device dependent editing at the device driver level. For 
example, line feeds are ignored on paper tape and teletype input devices and are 
supplied after carriage returns to all paper tape and teletype output devices. 
Moreover, reading and writing do not require byte counts since reading continues 
until a terminator is read and writing proceeds until a terminator Is written. The 
line mode commands are . RDL and .WRL, read and write a line. 

The third mode is sequential mode . In this mode data is transmitted exactly as 
read from the device or from core memory. No assumption is made bv the system 
as to the nature of this information. Thus this mode would always be used for 
processing binary data. This mode requires the caller to specify a byte count for 
each read or write request. The sequential mode commands are . RDS and . WRS, 
read and write sequential. 

Free format I/O permits the reading or writing of data on a word by word basis 
to cassette or magnetic tape. This mode provides users with the means of accessing 
data in 'variable size records within tape files. Free format I/O permits the 
reading or writing of data records containing from 2 to 4096 words each. Free 
format I/O commands also permit a tape reel to be spaced forward or backward 
from 1 to 4095 records or to the start of a new data file, and these commands permit 
the transport status word to be read. 
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FILE AND INPUT/OUTPUT COM VIANDS (Continued) 

Before free format I/O operations can be performed, the cassette or magnetic 
tape unit, must be initialized (. INIT) and opened (.MTOPD). To prevent further 

I/O access from occurring, the device is released (. RLSE) and its channel is 
closed (.CLOSE), 

Open a File or Device -. , OPEN) 

Before other I/O commands can be used, files and devices must be linked to channels, 
Two parameters must be passed to . OPEN : a byte pointer to the device or file 
name string, and a characteristic inhibit mask. 

For every bit set in the characteristic inhibit mask word a corresponding device 
characteristic is inhibited. (This mask is ignored when .OPEN is opening a file. ) 
Furthermore, these characteristics will be inhibited for as long as the device 
remains open. The following lists the bit assignments, characteristic mnemonics, 
and the characteristics in the inhibit mask: 

Bit Mnemonic Meaning 

1 DCC80 80-column device. 

2 DCLTU Device changing lower case ASCII to upper case. 

3 DCFFO Device requiring a form feed on open. 

4 DCFWD Full word device (reads or writes more than a 

byte). 

6 DCLAC Device requiring line feeds after carriage returns. 

7 DCPCK Input device requiring a parity check; output 

device requiring parity computation. 

8 DCRAT Output device requiring a rubout after every tab. 

9 DCNAF Output device requiring nulls after every form 

feed. 

10 DCKEY A keyboard input device. 

11 DCTO A teletype output device. 

12 DCCNF Output device without form feed hardware. 

14 DCCGN Output device without tabbing hardware. 

15 DCCPO Output device requiring leader /trailer. 

If an MCA line is being opened, AC1 cannot contain a characteristic inhibit mask. 
Instead, for receiver lines, AC1 must be cleared to all zeroes. If a transmitter 
line is to be opened and the default number of retries (specified at RTOSGEN 
time) is to be used, ACI must be cleared to all zeroes. However, if a different 
timeout value is to be specified, bit 15 of ACI must be set to one (and all other 
bits in ACI must be cleared). The actual specification of a retry count will then 
be deferred to the time the write sequential I/O command (.WRS) is issued. 



2-4 



Open a File or Device (. OPEN) (Continued) 

Having opened a file via . OPEN, the user is not guaranteed of being die exclusive 
user of the file; others may also have opened the file via » OPEN and may have 
modified its contents, lliis command cannot be used to open a cassette or 
magnetic tape file. 

T::- d/om..'. n N_- . O p E\' c r->-y\._ L --j is: 

AGO - Byte pointer to file or device name terminated by a null. The 
pointer must be even, i. e., the string must begin on a full word 
boundary. 

AC1 - Characteristic inhibit mask. 

.SYSTM 

. OPEN n ; OPEN CHANNEL n 

error return 

normal return 

In general, the user will wish to preserve all device characteristics as defined by 
the system. This can be accomplished by preceding the . OPEN call with a SUB 
1> 1 instruction, passing an all-zero mask in AC1. 

As an example, if the user wishes to read an ASCII tape without parity from the 
high speed reader, he may inhibit parity checking by the following command 

sequence: 

LDA 0, READR 

LDA 1, MASK 

.SYSTM 
. OPEN 3 

READR: .+1*2 

.TXT *PTR* 
MASK: DCPCK ; PARITY CHARACTERISTIC 

Possible errors resulting from the .OPEN command are: 

Meaning 

Illegal channel number. 

Illegal file name. 

File does not exist. 

Attempt to use channel already in use. 

Unit improperly selected. 

Attempt to open a busy MCA unit. 
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AC2 


Mnemonic 





ERFNO 


1 


ERFNM 


12 


ERDLE 


21 


ERUFT 


31 


ERSEL 


60 


ERFIU 



Get the Number of a Free Channel (. GCHN ) 

This call enables the user to obtain the number of a channel that is currently unused, 

if any, so that a file may be opened on this channel via one of the file open calls, 
, GCHN does not open a file on a free channel; it merely indicates a channel that is 
free at the moment, Thus if . GCHN is issued hi a multitask environment where it 
is followed by a call to one of the file open commands, the channel may not be free 
by the time the file open call is issued. To solve this problem, the user should 
process error return ERUFT ("Channel already in use") given by the file open 
command by reissuing the call to . GCHN; this will ensure that a truly free channel 
is discovered. 

The format of this call is: 

.SYSTM 
, GCHN 
error return 
normal return 

Upon a normal return, the channel number is returned in AC2: 

AC2 - Free channel number 

One possible error return may occur. 

AC2 Mnemonic Meaning 

21 ERUFT No channels are free. 

Open a Device for Appending (.APPEND ) 

An alternate system call for opening a device is implemented that is identical to 
. OPEN in every respect except that it may not be used with disk files. 

This routine requires the same two input parameters as does .OPEN, viz. , a 
byte pointer to the device name string, and a characteristic inhibit mask. The 
mask bit definitions are as described earlier for . OPEN . 

The format of the .APPEND command is: 

AGO - Byte pointer to device name. The pointer must be even, i.e. , the string 
must begin on a full word boundary. The string must be terminated by a 
null. 

VC1 - CNnucterist'c inhibit mask. 
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Open a Device for Appending (. APPEND) (Continued) 

.SYSTM . 
.APPEND n 
error return 
normal return 

Possible errors resulting from the .APPEND command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

21 ERUFT Attempt to use channel already in use. 

Close a File or Device (. CLOSE) 

This command closes a device (performing any housekeeping required like trailer 
output) and frees the device channel. If a file is closed, the file's channel is 
released. Hie format of the .CLOSE command is: 

.SYSTM 

.CLOSE n ;CLOSE CHANNEL n 

error return 

normal return 

Possible errors resulting from a .CLOSE command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

15 ERFOP Attempt to reference a channel not in use. 

Close all Files and Devices (.RESET) 

This command causes all currently open files and devices to be closed. The 
format of the . RESET command is: 



.SYSTM 
.RESET 

error return 
normal return 

The error return is never taken. 
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initialize a Magnetic Tape Unit or Cassette (. UNIT) 

Before free format tape I/O can occur, the magnetic tape unit or cassette must be 
initialized. Initialization for a magnetic tape unit or cassette consists of making 
the device known to the system, rewinding the tape to BOT, and resetting the tape 
file pointer to zero, 

A full initialization causes the tape to be rewound to BOT and two end -of -file marks 
to be written. This effectively erases any information which may have been on the 
tape. A partial initialization causes the tape to be rewound to BOT and resets the 
system tape file pointer to zero; no end of file mark is written. 

Input parameters to this call are as follows: 

AGO - Byte pointer to cassette or magnetic tape name (e.g., MTO, CT2, etc.). 

Hie byte pointer must be even, i.e. , the string must begin on a full 

word boundary. 
AC1 - -1 for full initialization; other values indicate a partial initialization. 

The format of the . INIT command is: 

.SYSTM 
. INIT 

error return 
normal return 

Possible errors resulting from an . INIT command are: 

Meaning 

Illegal command for device. 

Unit improperly selected ("unit ready" not set). 

Device not in system. 
Device already initialized. 

Open a Cassette or Magnetic Tape I'r.it Tor Tree Format I '() t.MTOPD ) 

Before free format reading or writing can be performed on either an initialized 
magnetic tape or cassette unit, the device must be opened and be linked to an 
RTOS channel. The RTOS command to open files or devices (.OPEN) cannot 
be used to open a magnetic or cassette tape unit for free format I/O; only 
.MTOPD can be used to open these devices. 



AC2 


Mnemonic 


2 


ERICM 


31 


ERSEL 


36 


ERDNM 


45 


ERIBS 
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Input parameters to this call are the same as for the .'■ ^-"^ command, .1 ' " "? ") 

positions a free format tape to a desired file, since the file name passed to .MTOPD 
will be of the form MTn:m or CTnrm , Hie input parameter to .MTOPD is as 
follows : 

AGO - Byte pointer to cassette or magnetic tape file name terminated by a null. 
The pointer must be even, i, e. » the string must begin on a full word 
boundary. 

The format of the MTOPD command is: 

.SYSTM 

.MTOPD n ;n IS THE CHANNEL NUMBER 

error return 
normal return 

Possible errors resulting from a .MTOPD command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

1 ERFNM Illegal file name. 

12 ERDLE File does not exist. 

21 ERUFT Attempt to use channel already in use. 

31 ERSEL Unit improperly selected. 

'cere a Magmrir Ta . v Urn: m: Omsmm ' . a U SE • 

To prevent further file access to either a magnetic tape or cassette unit, the system 
command . RLSE must be issued. This command prevents further file access until 
the device is initialized (see the . INIT command), and causes the tape to be rewound 
to BOT. 

One input parameter is required for this call: 

AGO - Byte pointer to device name. The byte pointer must be even, i.e., the 
string must begin on a full word boundary. 

The format of this call is : 

.SYSTM 

.RLSE 

error return 
normal return 
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Release a Magnetic Tape Unit or Cassette (.RLSE) (Continued) 

Possible errors resulting from an . RLSE command are: 

AC 2 Mnemonic Meaning 

2 ER1CM Illegal command for device. 

31 ERSEL Unit improperly selected ("unit ready" not set). 

36 ERDNM Device not in system. 

Read a Series of Disk Blocks (.RDB) 

This command causes a series of disk blocks to be read into a user -specified 
area in core memory. This routine requires four input parameters including 
the number of the channel upon which the disk file was previously opened. These 
parameters are: the starting disk block number within the disk file, the number 
of disk blocks to be read, and the starting (i.e. , lowest) core address to receive 
the data. In the case where the channel number n in the command argument is set 
to 77, the right byte of AC2 contains the channel number. The left byte of AC2 
contains the number of blocks to be transferred. Each block that is read contains 
256 16-bit words of disk storage. 

The format of the . RDB command is: 

AGO - Starting core address to receive the data. 
AC1 - Starting relative disk block number. 
AC2, left byte - Number of blocks to be read. 
AC2, right byte - Optional channel number. 

. SYSTM 

.RDB n ;n IS THE CHANNEL NUMBER. 

error return 

normal return 

Possible error codes resulting from an .RDB command are: 

AC2 Mnemonic Meaning 

ERFNO Illegal channel number. 

3 ERICD Illegal command for device. 

6 EREOF End of file. 

15 ERFOP File is not opened. 

Upon detection of error EREOF the error code is returned in the right byte of 
AC2; the left byte of AC2 contains the partial read count. 
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Read a Line (. RDL) 

This command causes an ASCII line to be read, Required input to this command 
is a byte pointer in AGO to the starting byte address within the user area into 
which the line will be read. This area should be 133 bytes long, 

Reading will be terminated normally after a carriage return, form feed, or null 
is detected, Reading will be terminated abnormally after reading 132 (decimal) 
characters without detecting a carriage return, form feed, or null; upon 
detecting a parity error; or upon an end of file. In all cases the read byte count, 
including the carriage return, form feed, or null, will be returned in AC1. 

If the read Is terminated because of a parity error, the character having the 
incorrect parity will be stored (with its parity bit cleared) as the last character 
read. The byte pointer to the character in error can always be computed as: 

(AC0) + (AC1)-1 * 

The format of the . RDL command is: 

AGO - Starting byte address. 

.SYSTM 

• RDL n ;READ FROM CHANNEL n 

error return 

normal return 

AC1 - Byte count. 

Possible errors resulting from a .RDL command are: 

Meaning 

Illegal channel number. 
Illegal command for device. 
End of file. 

Attempt to read an unopened file. 
Line limit (132 characters) exceeded. 
Parity error. 

Simultaneous reads on same QTY line. 
QTY input terminated by channel close. 



* (ACn) means "contents of ACn" 
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AC2 


Mnemonic 





ERFNO 


3 


ERICD 


6 


. EREOF 


15 


ERFOP 


22 


ERLLI 


24 


ERPAR 


47 


ERSIM 


106 


ERCLO 



Read Sequential (. RDS) 

This command causes a sequential mode data transfer, causing data to be read 
exactly as is. Required input parameters to this command are as follows: a byte 
pointer to me starting byte address within the user area into which data will be 
read, and die number of bytes (2 15 -1 maximum) to be read. 

The format of the ,RDS command is: 

AGO - Starting byte address. 
AC1 - Number of bytes to be read. 

.SYSTM 

.RDS n ;READ SEQUENTIAL FROM CHANNEL n 

error return 

normal return 

Possible errors resulting from an .RDS command are: 

Meaning 

Illegal channel number. 

Illegal command for device. 

Attempt to read an unopened device or file. 

Simultaneous reads on same QTY line. 
QTY/MCA input terminated by channel close. 

Use of the Card Reader in .RDL and .RDS Commands 

When using $CDR or $CDR1, the end of file condition on a . RDL will occur only if 

a special end of file code is detected in column 1 of a card. This code is "all rows 
punched. " It can be punched on a 029 keypunch by multipunching "+"» "-", and "0" 
through "9. " 

Note also that a Hollerith to ASCII translation only occurs if a .RDL has been 
requested. The translation assumes 029 keypunch codes. A table of Hollerith- 
ASCII translation is given in this section. 

A .RDL is terminated upon the first trailing blank (which is translated as a 
carriage return). If all 80 columns are data, a carriage return is appended as the 
eighty -first character. If an illegal character is detected, a back slash is sub- 
stituted for the Illegal character. 



AC2 


Mnemonic 





ERFNO 


3 


ERICD 


15 


ERFOP 


47 


ERSLM 


106 


ERCLO 
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Use of the Card Reader in . RDL and . RDS Commands (Continued) 

In an . RDS command, the card is read in image binary. Each two bytes will be 
used to store a single column. The packing is done as follows: 



Byte 



■> <r 



Column Number 



1 1 

2 1 



0123456789 



Bit 



0123456789111111 

12 3 4 5 




The "d's" will be 1 for every column punched. 

The byte count and byte pointer input to an . RDS command must both be even. 



2-13 



CHAR, 


CARD CODE 


ASCII CODE 



CHAR. 



CARD CODE 



ASCII CODE 



NUL 


12-0-9-8-1 


000 


SOH 


12-9-1 


001 


STX 


12-9-2 


002 


ETX 


12-9-3 


003 


EOT 


9-7 


004 


ENQ 


0-9-8-5 


005 


ACK 


0-9-8-6 


006 


BEL 


0-9-8-7 


007 


BS 


11-9-6 


010 


HT 


12-9-5 


011 


LF 


0-9-5 


012 


VT 


12-9-8-3 


013 


FF 


12-9-8-4 


014 


CR 


12-9-8-5 


015 


SO 


12-9-8-6 


016 


SI 


12-9-8-7 


017 


DLE 


12-11-9-8-1 


020 


DC1 


11-9-1 


021 


DC2 


11-9-2 


022 


DC3 


11-9-3 


023 


DC4 


4-8-9 


024 


NAK 


9-8-5 


025 


SYN 


9-2 


026 


ETB 


0-9-6 


027 


CAN 


11-9-8 


030 


EM 


11-9-8-1 


031 


SUB 


9-8-7 


032 


ESC 


0-9-7 


033 


FS 


11-9-8-4 


034 


GS 


11-9-8-5 


035 


RS 


11-9-8-6 


036 


US 


11-9-8-7 


037 



3 ACE 


MO PUNCHES 


040 


! 


12-8-7 


041 


„ 


8-7 


042 


# 


8-3 


043 


$ 


11-8-3 


044 


% 


0-8-4 


045 


& 


* 

12 


046 


' or 


8-5 


047 


( 


12-8-5 


050 


) 


11-8-5 


051 


* 


11-8-4 


052 


+ 


12-8-6 


053 


9 


0-8-3 


054 


- 


11 


055 


• 


12-8-3 


056 


/ 


0-1 


057 








060 


1 


1 


061 


2 


2 


062 


3 


3 


063 


4 


4 


064 


5 


5 


065 


6 


6 


066 


7 


7 


067 


8 


8 


CO 


9 


9 


071 




8-2 


072 


; 


11-8-6 


073 


< 


12-8-4 


074 


= 


8-6 


075 


> 


0-8-6 


076 


? 


0-8-7 


077 



Hollerith - ASCII Translation Table 
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CHAR. 


CARD CODE 


ASCII CODE 




CHAR. 


CARD CODE 


ASCII CODE 


§ 


8-4 


100 


8-1 


140 


A 


12-1 


101 a 


12-0-1 


141 


B 


12-2 


102 b 


12-0-2 


142 





12-3 


103 c 


12-0-3 


143 


D 


12-4 


104 d 


12-0-4 


144 


E 


12-5 


105 e 


12-0-5 


145 


F 


12-6 


106 f 


12-0-6 


146 


G 


12-7 


107 g 


12-0-7 


147 


I! 


12-8 


110 h 


12-0-8 


150 


I 


12-9 


111 i 


12-0-9 


151 


J 


11-1 


112 j 


12-11-1 


152 


K 


11-2 


113 k 


12-11-2 


153 


L 


11-3 


114 1 


12-11-3 


154 


M 


11-4 


115 m 


12-11-4 


155 


N 


11-5 


116 n 


12-11-5 


156 


O 


11-6 


117 o 


12-11-6 


157 


P 


11-7 


120 p 


12-11-7 


160 


Q 


11-8 


121 q 


12-11-8 


161 


R 


11-9 


122 r 


12-11-9 


162 


S 


0-2 


123 s 


11-0-2 


163 


T 


0-3 


124 t 


11-0-3 


164 


U 


0-4 


125 u 


11-0-4 


165 


V 


0-5 


126 v 


11-0-5 


166 


w 


0-6 


127 w 


11-0-6 


167 


X 


0-7 


130 x 


11-0-7 


170 


Y 


0-8 


131 y 


11-0-8 


171 


z 


0-9 


132 z 


11-0-9 


172 


[ 


12-8-2 


133 { 


12-0 


173 


\ 


0-8-2 


134 1 


12-11 


174 


] 


11-8-2 


135 } 


11-0 


175 


— i or f 


11-8-7 


136 r~ 


11-0-1 


176 


- 


or — 


0-8-5 


137 




DEL 


12-9-7 


177 



Hollerith - ASCII Translation Table (Continued) 
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Write a Series of Disk Blocks (,WRB) 

This command causes a series of data blocks, each 256 16-bit words in size, to 
be written onto disk from a user- specified area in core memory. This routine 
requires four input paxameters including the number of the channel upon which the 
disk or disk file was previously opened. These paxameters are: the starting 
relative disk block number within the file, the number of disk blocks to be written, 
and the starting (i.e. , lowest) core address to transmit the data. In the case where 
the channel number n in the command argument field is set to 77, the right byte of 
AC 2 contains the channel number. The left byte of AC 2 contains the number of 
blocks to be written. 

The format of the . WRB command is: 

AGO - Starting core address to transmit the data. 
AC1 - Starting relative disk block number. 
AC 2, left byte - Number of blocks to be read. 
AC2, right byte - Optional channel number. 

. SYSTM 

. WRB n ;n IS THE CHANNEL NUMBER 

error return 

normal return 

Possible error codes resulting from an .WRB command are: 

Meaning 

Illegal channel number. 

Illegal command for device. 

File Is not opened. 

Disk space Is exhausted. 

Upon detection of error ERSPC, the error code Is returned in the right byte of 
AC 2; the left byte of AC 2 contains the partial write count. 

Write a Line (.WRL) 

This command writes a line to a user ASCII file. Required input to this command 

is a byte pointer in AGO defining the user core area from which writing will occur. 

Characters are written with even parity and writing will be terminated normally 
upon encountering a null, carriage return, or form feed. Writing will be ter- 
minated abnormally after the transmission of 132 (decimal) characters if 
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AC2 


Mnemonic 





ERF NO 


3 


ERICD 


15 


ERF OP 


27 


ERSPC 



Write a Line (.WRL) (Continued) 

the 133rd character is not a carriage return, form feed, or null, In all cases, 
AC1 will contain, upon termination of fee write, the number of bytes written from 
the user area. Hie termination of a write line on a null allows formatting of output 
without forcing a carriage return. 

The format of the .WRL command is: 

AGO - Starting byte address. 

.SYSTM 

.WRL n ;WRITE FROM CHANNEL n 

error return 
normal return 

AC1 - Byte count. 

Possible errors resulting from the .WRL command are: 

AC2 Mnemonic Meaning 

ERF NO Illegal channel number. 

3 ERICD Illegal command for device. 

15 ERFOP Attempt to write an unopened file. 

22 ERLLI Line limit (132 characters) exceeded. 

47 ERSIM Simultaneous writes on same QTY line. 

106 ERCLO QTY output terminated by channel close. 

Write Sequential (.WRS) 

This command writes binary data from a user core area. In addition to the channel 
number, two parameters are input: a byte pointer to the starting address of the- 
user area, and the number of bytes (2 l5 -l maximum) to be written. The byte pointer 
must be even if this call is issued for an MCA transmission. To transmit an end- 
of-file in an MCA transmission, a byte count of zero is used in AC1 and the contents 
of AGO are disregarded. Also, if the MCA transmit line was opened with a timeout 
to be specified, the left byte of AC2 Input to .WRS specifies the length of the timeout 
period. Each unit period is approximately 200 milliseconds, and acceptable multiples 
Input in AC2 are 1 to 255 decimal. A zero value yields the default timeout period 
specified at RTOSGEN time. 
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Write Sequential (.WRS) (Continued) 
The format of the .WRS command is: 

AGO - Starting address of the data within the user area, 

AC1 - Byte count, 

AC2, left byte - Optional timeout constant. 

AC2» right byte - Optional channel number. 

.SYSTM 

.WRS n ;WRITE TO CHANNEL n 

error return 
normal return 

Possible errors are: 

Meaning 

Illegal channel number. 

Illegal command for device. 

Attempt to reference an unopened file or device. 

Simultaneous writes on same QTY line. 

Timeout has occurred. 

No complementary MCA request. 

Incomplete MCA transmission due to short receiver 

request. 

MCA/QTY output terminated by channel close. 

No MCA receiver request. 

Free Format Tape I/O (.MTDIO) 

Tliis command permits the operation of magnetic tape and cassette units on a 
machine level: To read and write words in variable length records of from 2 
to 4096 words within a data record, to space forward or backward from 1 to 
4095 data records or to the start of a new data file, and to perform other similar 
machine level operations. Before free format I/O can be performed on a tape unit, 
that unit must first have been opened for free format I/O by means of the .MTOPD 
system command. 

The input parameters to .MTDIO are as follows: 

AGO - Core data address, if data is to be transferred. 
AC1 - Command word, subdivided into the following fields: 



AC2 


Mnemonic 





ERFNO 


3 


ERICD 


15 


ERFOP 


47 


ERSIM 


101 


ERDTO 


103 


ERMCA 


104 


ERSRR 


106 
113 


ERCLO 

ERNMC 
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Free Format Tape I/O (. MTDIO) (Continued) 

bit 0; set to 1 for even parity, for odd parity. 

bits 1-3: set to one of the seven command codes which follow, 

- read (words)* 

1 - rewind the tape 

3 - space forward (over records or over a file of any size) 

4 - space backward (over records or over a file of any size) 

5 - write (words) 

6 - write end of file 

7 - read device status word 

bits 4-15: word or record count. If on a space forward (or space 

backward) command, the tape is positioned to me beginning 
of the next (or previous) file on the tape. If on a read or 
write command 4096 words are read (or written) unless an 
end of record is detected. 

AC2 - channel number if n equals 77 g . (Note that when a file is opened for 
free format I/O, it is opened globally. That is, all files on the 
specified device can be accessed. ) 

The format of the . MTDIO command is: 

.SYSTM: 

.MTDIO n ;n IS THE CHANNEL NUMBER 

error return 

normal return 

Upon a rewind or read status command, if no system error is detected, AC2 returns 
containing a status word with one or more of the following bits set: 

bit - error (bit 1, 3, 5, 6, 7, 8, 10 or 14 is set to 1) 

bit 1 - data late 

bit 2 - tape Is rewinding 

bit 3 - Illegal command 

bit 4 - high density if set to 1; otherwise, low density (always 1 for cassettes) 

bit 5 - parity error 

bit 6 - end of tape 

bit 7 - end of file 



* When attempting to read a 7 -track tape with odd parity (I.e. , a tape not written on 
an RTOS system), the end -of -file is not detected by the controller; the first word 
in the next record Is read as 007417. Thus the first record of each file (after the 
first file) has appended to It the end -of -file of the previous file. 
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Free Format Tape I/O (. MTDIO) (Continued) 

bit 8 - tape is at load point 

bit 9 - 9-track if set to 1; otherwise, 7 -track (always set to 1 for casettes) 

bit 10 - bad tape or write failure 

bit 11 - send clock (always set to zero for cassettes)* 

bit 12 - first character (always set to zero for cassettes)* 

bit 13 - write-pro tected or write -locked 

bit 14 - odd character (always set to zero for cassettes) 

bit 15 - unit ready. 

For more information about each of these status bits, see "Nova Cassette" or 
"Magnetic Tape" in How To Use the Nova Computers . 

Upon a read, write, space forward, or space backward command, if no system 
error is detected, AC1 contains the number of words written (or read) or the 
number of records spaced. A word or record count is returned in AC1 upon a 
premature end of file. 

Upon detection of a system error, the error return is taken and AC2 is set to 
contain one of the following: 

Meaning 

Illegal channel number. 

Illegal command for device (i.e. , improper open). 

Attempt to reference an unopened file. 

File read error. 

If no system error is detected but a hardware error occurs (i.e. , bit of the 
status word is set), the error return is taken and AC2 is set to the transport status 
word. If no system error and no hardware error occurs, the normal return is 
taken and the transport status word is returned in AC2. 

The following table summarizes the return taken and contents of AC1 and AC2 with 
different MTDIO command selections. 



AC2 


Mnemonic 





ERFNO 


3 


ERICD 


15 


ERFOP 


30 


ERFIL 



"* Bits used for maintenance only, 
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Free Format Tape I/O (.MTDIO) (Continued) 

COMMAND RETURN 



AC1 



AC2 



Any MTDIO command with a J Error 

system error detected 


Same as 
input 


System error 
code 


Rewl",! (~>X : :>it ' = "> 


1 

Normal 


Original 
input is 
lost 


Transport status 
word (TSW) 


Rewind (TSW bit = 1) 


Error 


Read Status (TSW bit = 0) 


Normal 


Original 
input is 
lost 


TSW 

(status bit is 0] 


Read Status (TSW bit = 1) 


Error 


Original 
input is 
lost 


TSW 

(status bit is I] 


Read, Write, Space Forward, 
Space Backward; bit in TSW 
is set to 


Normal 


W r ord or 

Record 

count 


TSW 


Read, Write, Space Forward, 
Space Backward; bit in TSW 
is set to 1 


Error 

(only after 
10 retries 
in read/ 
write) 


W r rite end -of -file 
(TSW bit 0=1) 


Error 


Original 
input is 
lost 


TSW 



The system will perform 10 read retries before taking the error return. For 
write errors, the following sequence will be performed 10 times before taking 
the error return: backspace and write 9 times, then backspace, erase a 2-1/2" 
length of tape, and write. TTius the system will perform 100 write retries before 

signaling an error. 
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•;-;;l.:t; vii'TV i r; Ad .v::j y;:x-p display commands 

Transfer of single ASCII characters between $TTI/$TTO and AGO is handled by 
the system commands . GCHAR and . PCHAR , No channel is required for the 
transfers, and $TTI/$TTO is always available without requiring a prior .OPEN 
command. 

An additional system call exists which allows a task to be readied upon detection 
of a user- defined character input via a teletype or display keyboard. 

Get a Character ( . GCHAR) 

This command returns a character input via $TTI to AGO. The character is right 
adjusted in AGO with bits 0-8 cleared. No channel is required; the $TTI is always 
used as input for this command. The format of the . GCHAR command is: 

. SYSTM 
. GCHAR 
error return 
normal return 

AGO, bits 9-15 - ASCII input character 

No error return is possible from this command. 

Put a Character (.PCHAR) 

This command transmits a character in AGO, right adjusted, to $TTO. No channel 
is required, and the $TTO is always used with this command. The format of the 

. PCHAR command is: 

AGO, bits 9-15 - ASCII output character 

. SYSTM 
.PCHAR 
error return 
normal return 

No error return is possible from this command. 



2-22 



Wait for a Keyboard Character (, WCHAR) 

This command suspends the caller until either a specified character is typed onto 
any console keyboard, or the call is reissued by another task to terminate this 
keyboard wait. Only one task may be suspended for a keyboard character wait 
at any one moment. 

The required input to this call is either the keyboard character which will ready the 
task or -1, terminating the keyboard character wait and readying the suspended 
task. These parameters are input via AGO, Since the calling task may be readied 
by either the transmission of a specified keyboard character or by the keyboard wait 
call being terminated, an appropriate code is returned in AC1 when the normal 
return is taken. This code will be either the device code of the console keyboard 
which issued the requested wait character, or -1; -1 indicates that the previous 
wait was terminated. 

The format of this call is: 

AGO - Wait character in right byte, or -1 to terminate another 
task's wait request. 

. SYSTM 
. WCHAR 
error return 
normal return 

AC1 - Device code of the keyboard transmitting the wait character, 
or -1. Minus 1 indicates that the previous wait request 
was terminated. 

The error return is taken if a second task tries to suspend itself for a keyboard 
character while another task is still suspended for a wait character. In this 
case, AC2 is set to the following: 



AC2 Mnemonic Mea 



mng 



47 ERSM A previous wait-character request is outstanding. 

MEMORY SIZE COMMANDS 

RTOS provides a pair of system commands used to determine the highest location 
of the loaded user program (NMAX), the highest memory address available In 
user address space (HMA), and a means to increase or decrease the address 
space allocated to the user program by varying NMAX, NMAX is a pointer 
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MEMORY SIZE COMMANDS 'Con'-iTu.-.' i 

contained in the User Status Table at displacement USTNM; this table is discussed 
in Chapter 5, SYSTEM ORGANIZATION . (Note that the /S switch must not be used 
in the RLDR command, ) 



400 




HMA 



Binary Loader 



NMAX 



Symbol Table 



User Program 



-•-HMA 



.NMAX 



Memory Maps with and without Symbol Table 

Determine Available Memory (.MEM) 

This command returns the current value of NMAX and the value of HMA. HMA 

represents the location immediately below the bottom of the binary loader (or 

the top of the symbol table). A SUB 1, instruction after the .MEM call determines 

the additional amount of memory available to the user program by putting its 

value in AGO. 

The format of the .MEM command is: 

. SYSTM 
.MEM ' 
error return 
normal return 

AC1 - NMAX. 
AGO - HMA. 

There are no error returns from this command. 



Allocate Memory by Changing NMAX (. MEMI) 

This command returns the current value of NMAX and the value of HMA. HMA 
represents the location immediately below the bottom of the binary loader (or 
the top of the symbol table). A SUB1, instruction after the . MEM call 
determines the additional amount of memory available to the user program 
by putting its value in AGO. 
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Allocate Memory by Changing NMAX (. MEMI) (Continued) 

NMAX will not be changed if the new value would be equal to or higher than the 
lowest address of the binary loader. No check is made as to whether or not the 
user decreases NMAX below its original value (as determined at relocatable 
load time) nor, if a symbol table resided in upper memory, whether NMAX is 
increased beyond the bottom of the symbol table. 

The format of the .MEMI command is: 

AGO - NMAX increment or decrement : 

.SYSTM 
.MEMI 
error return 
normal return 

AC1 - New NMAX. 

There is one error which may result from a .MEMI command: 

AC2 Mnemonic Meaning 

26 ERMEM Attempt to overwrite the binary loader. 

SYSTEM RETURN COMMANDS 

These calls return control to their error returns unconditionally. 

System Return (.RTN) 

This command stops all tasks (except the caller), closes all channels, and 
returns control unconditionally to the error return; no normal return is reserved. 
The format of the . RTN command is: 

. SYSTM 
.RTN 
error return 

The following error code is returned: 

AC2 Mnemonic Meaning 

23 ERRTN Attempt to restore a nonexistent image (as in RDOS). 
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System Error Return (. ERTN) 

This command stops all tasks (except the caller), closes all channels, and returns 
control unconditionally to the error return; no normal return is reserved, The 
format of the . ERTN command is as follows: 

, SYSTM 
.ERTN 
error return 

The following error code is returned in AC2: 

AC2 Mnemonic Meaning 

23 ERRTN Attempt to restore a nonexistent image (as in 

RDOS). 

CLOCK AND CALENDAR COMMANDS 

RTOS clock and calendar commands may be used in any system which includes a 
real time clock, RTOS clock and calendar commands permit ready tasks to be 
suspended for a period of time* permit the system real time clock to be examined, 
and allow the creation of a user clock to specify a recurring interruption of 
multitask activity. 

Delay the Execution of a Task (. DELAY) 

This command suspends the caller for a specifiable number of pulses of the system 
real time clock. Thus this command permits the creation of a time slicing facility 
within RTOS. The system real time clock frequency is set when a system is 
generated, and no system call can alter this frequency. 

The format of the .DELAY command is: 

AC1 - Number of RTC pulses in the delay period. 

.SYSTM 
.DELAY 

error return 
normal return 

Contents of AC1 are lost upon return. One possible error may occur: 
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Delay the Execution of a Task (. DELAY) (Continued) 

AC2 Mnemonic Meaning 

2 ERICM Illegal system command (i, e. » no RTC in system). 

Get Today's Date (. GDAY) 

This command requests the system to return die number of the current day, month, 
and year. The day is returned in AGO, the month in AC1, and the year in AC2. The 
The format of the . GDAY command is: 

.SYSTM 
.GDAY 
error return 
normal return 

AGO - Day of the month. 

AC1 - Month of the year. 
AC2 - Year. 

The error return is never taken. 
Set Today's Date (.SPAY) 

This command permits the system calendar to be set to a specific date. The system 
will increment the date when the time of day passes 23 hours, 59 minutes, and 59 

seconds. The caller passes the number of the day within the month in AGO, the 
number of the month in AC1 (January is month number 1), and the current year in 
AC2. The format of the . SDAY command is: 

AGO - Day of the month. 

AC1 - Month of the year. 
AC2 - Year. 

.SYSTM 
. SDAY 
error return 
normal return 

One possible error return is: 

AC2 Mnemonic Meaning 

41 ERTIM Illegal day, month or year. 
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Get the Time of Day (. GTQD) 

This command requests the system to pass the current time in hours, minutes 
and seconds to the caller. Tne format of the . GTOD command is: 

.SYSTM 
.GTOD 
error return 
normal return 

AGO - Second. 

AC1 - Minute. 

AC2 - Hour (using a 24 -hour clock). 

No error return is possible. 

Set the Time of Day (.STOP) 

This command permits the caller to set the system clock to a specific hour, 
minute, and second. The format of the .STOD command is: 

AGO - Second* 
AC1 - Minute. 
AC2 - Hour (using a 24-hour clock). 

.SYSTM 
.STOD 
error return 
normal return 

If the error return is taken, the following error code is given: 

AC2 Mnemonic Meaning 

4 1 ERTIM Illegal time of day. 

Examine die System Real Time Clock (.GHRZ ) 

This system call permits the caller to examine the frequency of die real time 
clock (die frequency was set when the RTOS system was generated). One of 
five frequency codes is returned in ACO, as described below. The format of the 
.GHRZ command is: 
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Examine the System Real Time Clock (.GHRZ) (Continued) 

•SYSTM 
.GHRZ 

error return 
normal return 

AGO: - there is no real time clock in the system, 

1 - the frequency is 10HZ. 

2 - the frequency is 100HZ. 

3 - the frequency is 1000HZ. 

4 - line frequency is 60HZ. 

5 - line frequency is 50HZ. 

The error return is never taken. 

Define a User Clock (.DUCLK) 

This command permits the definition of a user clock. When the user -defined 
interval expires, the task scheduler and multitask environment- -if any- -are 
placed in suspension, and control goes to a user -specified routine outside the 
task environment. No task calls' (other than . UCEX and . IXMT) may be issued 
from this interrupt routine, since multitask activity is in suspension. Only one 
user clock may be defined at any one moment. 

The format of the .DUCLK command is: 

AGO - Number of RTC pulses during each user clock interval. 
AC1 - Address of user interrupt routine. 

.SYSTM 
.DUCLK 
error return 
normal return 

Only one error condition is possible: 

AC2 Mnemonic Meaning 

45 ERIBS A user clock already exists. 
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Exit from a User Clock Routine (. UCEX) 

Upon a user clock interrupt, ACS will contain the address of the return upon 
entry to the routine specified in . DUCLK. To return from the user clock routine, 
ACS must be loaded with the return address that it contained upon entry to the 
routine, and task call .UCEX must be issued, 



' T h_- fom.u ol t'ds c-:iV, is: 

AC3 - Return address upon entry to routine. 

. UCEX 

Control returns to the point outside the user routine which was interrupted by 
the user clock. No errors are possible from this call. This call can be issued 
in a single task environment. 

Remove a User Clock (.RUCLK) 

This system command removes a previously defined user clock from the system. 

The format of this call is: 

.SYSTM 
.RUCLK 
error return 
normal return 

The error return is never taken. 
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CHAPTER 3 



TASK CALLS 



The following is a list of all RTOS task call mnemonics: 



. ABORT 
,AK1LL 
, ARDY 
. ASUSP 
, DQTSK 
. IDST 
,IXMT 
, KILAD 
.KILL 
,PRI 
,QTSK 
REC 
,SUSP 
SMSK 
,TASK 
TIDK 
TIDP 
TIDR 
TIDS 
UCEX 
UIEX 
UPEX 
XMT 
XMTW 



Terminate a task immediately. 

Kill -j11 ta^k< of />. sivcifieJ priority. 

Ready all tasks of a specified priority. 

Suspend all tasks of a specified priority. 

Dequeue a queued task, 

Get a task's status by I. D. number. 

Transmit an interrupt message. 

Define a kill- processing address. 

Kill the calling task. 

Change the calling task's priority. 

Queue a task for periodic execution. 

Receive a task message. 

Suspend the calling task. 

Modify the current interrupt mask. 

Create a task. 

Kill a task specified by I. D. number. 

Change the priority of a task specified by I. D. number. 

Ready a task specified by I. D. number. 

Suspend a task specified by I. D. number. 

Exit from a user clock routine. 

Exit from a user interrupt routine. 

Exit from a user power fail routine. 

Transmit a task message. 

Transmit a task message and wait for its receipt. 



Multitasking Concepts Summary 

A full description of RTOS multitasking concepts is given in Chapter 1 of this 
manual and in the Introduction to RTOS , 093-000093. The following summary 
Information is given to review these concepts. 

Before a task can be run, it must be made known or initiated to the system. Tasks 
can be initiated by either the .TASK or , QTSK task calls. .TASK simply initiates 
a task, while . QTSK initiates the task for execution on a periodic basis. 

Tasks which have been initiated into the system exist in one of three states: 
execution, ready, or suspended. The executing task Is that task which is currently 
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Multitasking Concepts Summary (Continued) 

in control of the CPU, A ready task is a task which is awaiting being raised to the 
execution state. A suspended task is one which, for one reason or another, is 
awaiting being raised to the ready state and can never gain control until it is so 
raised. Calls , SUSP and . ASUSP can be used to place one or more tasks in the 
suspended state. , ARDY is used to raise a group of tasks which are all at the 
same priority to the ready state, 

Tasks are not only distinguished by their system states; they are also differentiated 
by priority and optionally by identification numbers, Although task priority is 
defined at the time that each task is initiated, task priority can be changed by the 

• PRI call. Task identification numbers are also established when a task is 
initiated. Several task calls are used to perform task functions on specific tasks 
identified by I. D. number. These calls are . IDST, . TIDK, .TIDP, .TIDR, and 

. TIDS. 

A mechanism is provided for transmitting and receiving one-word messages 
between single tasks only. This mechanism can also be used to lock a task 
process, preventing multiple tasks from entering the process concurrently. 
One-word messages are deposited in locations whose contents are set to zero 
when they contain no message. If several tasks attempt to receive a message from 
the same address, only the highest priority task will receive the message. 

The .REC and . XMT commands can be used to lock and unlock a process or data 

base which is shared by several tasks, preventing more than one task at a time 
from accessing the data base or the process path* In essence, the procedure is 
to define a synchronization word, the message location, which all tasks will 
attempt to receive. The task in control of the locked resource then issues an 

• XMT to the synchronization word when the resource is to be made available to 
the other waiting tasks. The highest priority task waiting to receive (. REC) the 
synchronization word is then readied and gains unique control of the resource. 
This task, in turn captures the use of the resource until it unlocks the resource 
by issuing an . XMT to the synchronization word, etc. 

This technique requires that the locking facility be initialized before any tasks use 
it. Initialization can be performed either by setting the synchronization word 
initially to a non-zero value, or by having an initialization task issue an . XMT to 
the synchronization word. 

The operating system provides a variety of means to terminate task operations. 
Tasks can be killed within a user program in an orderly fashion, or task 
operations can be halted abruptly (.ABORT). Tasks can be killed in an orderly 
fashion either singly by an L D number (.TIDK), as a priority group (. AKILL), 
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Multitasking Concepts Summary (Continued) 

or the calling task can kill itself (.KILL*, To ensure that a task can be terminated 
in an orderly fashion, RTOS provides a facility to define for each task a special 
reprieve routine which will gain control upon an attempted orderly kill. 

Upon most orderly task terminations, . AK1LL or , TIDK, each task to be terminated 
is readied unless it was suspended due to a . SYSTM call. Thus if it was sus- 
pended by a ,REC» . XMTW, .SUSP, or . TIDS task call, the suspension would be 
lifted, If the task were in suspension due to an outstanding . SYSTM call, that 
call would be completed before the task was readied. In either case, after the 
task to be killed has been elevated to the ready state, one of two actions then 
occurs depending upon the intention of the user. First, if no reprieve address 
is provided, then the task is simply terminated. 

Alternatively* if the user wishes, a special kill- processing or reprieve address 
could have been specified for the task. If such an address has been specified, 
then when the task to be killed receives control, control goes to this special 
processing address. This facility gives the user flexibility in providing an orderly 
release of resources should the task be killed. The kill- processing routine can 
act as a reprieve, since the task executing this routine will not actually be 
terminated until it itself issues a .KILL call. Thus the kill-processing routine 
can also be used as a validation procedure to determine whether or not the 
target task should be terminated. 

The case of self-termination, . KILL, Is special. If a task attempting to terminate 
Itself has a kill- processing address specified, then upon issuing the . KILL call 
this task will be readied and will gain control in it's turn at its kill-processing 
address. If It has defined no such address, then the task will be terminated 
immediately. 

Whether orderly kills or aborts are used to terminate a task, when the task is 
terminated its TCB is relinquished to the free TCB pool for possible use In the 
initiation of other tasks. 

Tasks which were initiated by a . QTSK call have their periodic execution halted by 
means of a . DQTSK call. If a queued task is currently running, however, it will 
continue to run until It terminates itself or is terminated. 

All RTOS task calls except . SMSK, .UCEX, .UIEX and .UPEX are described in 
this chapter in alphabetical order. .UCEX is found in Chapter 2, and the re- 
m dnrw -t-.isk c.-IN •; >v described in Chuptcr 4. 
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Abort a Task (.ABORT) 

The .ABORT task call causes a specified task to be readied immediately and to 
execute the equivalent of a . KILL task call as soon as it gains control of the CPU. 
The exact time of completion of the , KILL is dependent on the priority of the 
aborted task relative to other ready tasks. For example, a task attempting to 
perform a write sequential of 500 bytes might be aborted after writing any 
number of bytes. 'The task which is to be aborted is specified by I. D. number. 
Thus the caller may abort either itself or some other ready or suspended task. 

Outstanding operations performed by the task, like waiting for a message trans- 
mission/reception (, XMTW/. REC), are terminated. Likewise, all system calls 
are aborted with the exception of calls performing QTY or MCA I/O, QTY and 
MCA I/O can be aborted by closing their charrael(s) with a . CLOSE or . RESET 
system command. 

The format of this call is as follows: 

AC1 - I. D. of the task to be aborted. 

. ABORT 
error return 
normal return 

The contents of AGO is lost upon return. 

Tiae error return is taken under one of two conditions: 

AC2 Mnemonic Meaning 

61 ERTID An I. D. of zero was specified, or no such task I. D. -was 

found. 
110 ERABT The specified task was performing QTY or MCA I/O. 

Kill All Tasks of a Specified Priority {. AKILL) 

This command either kills all tasks of a given priority 7 or transfers control to tHeir 
kill -processing addresses. All TCBs that are deleted from the active queue are 
placed in the free TCB chain. Tasks in suspension due to , XMTW, . TIDS, . REC, 
or . SUSP calls will be raised to the highest priority ready state immediately. If 
an attempt Is made to kill a task suspended by an outstanding . SYSTM call, that 
task will be raised to the highest priority at the completion of the . SYSTM call. 
The calling task itself may be deleted by this command. 
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Kill All Tasks of a Specified Priority (. AKILL) (Continued) 

The format of this call is: 

AGO - Task priority. 

.AKILL 

normal return 

There is no error from this call. If no tasks exist with the priority specified in 
AGO, no action Is taken. If all tasks become deleted, the effect is to close all the 
channels and to idle the system, since control returns to the task scheduler. 

Ready All Tasks of a Specified Priority (.ARDY) 

This call readies all tasks which were previously suspended by .ASUSP (.SUSP 
or .TIDS) whose priority is specified in AGO. That is, bit 1 in word TPRST of 
each TCB (see Chapter 5) that was set by a previous call to .ASUSP, .SUSP, or 
.TIDS is now reset. Tasks suspended for other reasons too (e.g. , outstanding 
system calls) will only be readied when the task is fully ready, i.e. , bits 
and .2 are also reset. The format of this call is: 

AGO - Task priority. 

.ARDY 
normal return 

There is no error return from this call. If there are no tasks with the priority 
specified in AGO, no action is taken and control goes to the normal return. 

Suspend All Tasks of a Given Priority (.ASUSP) 

This command suspends all tasks with the priority given in AGO, The calling task 
itself may be suspended by this call. All tasks suspended by . ASUSP (including 
those additionally suspended for other reasons such as an outstanding system call 
or waiting for a task message transmission) will remain suspended until readied 
by an . ARDY or . TEDR command. 

The format of this call is; 

AGO - Task priority. 

. ASUSP 
normal return 
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Suspend All Tasks of a Given Priority (. ASUSP) (Continued) 

There is no error return from this call. If no tasks exist with the given priority, 
no action is taken and control goes to the normal return. 

Dequeue A Core-resident or Overlay Task (.DQTSK) 

This call causes a task which has been queued for execution by task call ,QTSK to 
be dequeued. In effect, the , DQTSK call bypasses the value which is currently 
stored in displacement QNUM of the task's User Task Queue Table. If at some 
later moment the task is requeued by a call to .QTSK, the queuing process will 
resume its normal course since . DQTSK does not actually modify the contents 
of QNUM. 

The format of this call is as follows: 

AC1 - I. D. of the task to be dequeued. 

.DQTSK 
error return 
normal return 

Upon a normal return, AC2 returns the base address of the task's queue table 
(QPC). If the error return is taken, the following code is given: 

AC 2 Mnemonic Meaning 

61 ERTID Task I. D. error. 

Get a Task's Status (.IDST ) 

This command obtains a code describing a task's status. The task whose status 
is to be obtained is specified by inputting its identification number in AC1. The 
format of this call is: 

AC1 - Task I. D. number 

.IDST 

normal return 
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Get a Task's Status (.IDST ) (Continued) 

- Ready. 

1 - Suspended by a . SYSTM call, 

2 - Suspended by . SUSP, . ASUSP, or . TIDS. 

3 - Suspended by . XMTW or . REC e 

4 - Not used. 

5 - Suspended by . ASUSP, . SUSP, or . TIDS and by c SYSTM. 

6 - Suspended by .XMTW or .REC and by , SUSP, .ASUSP, or .TIDS, 

7 - Not used. 

10- No task exists with the specified I. D. number. 

There is no error return from this call. 

Transmit a Message from a User Interrupt Service Routine (. IXMT) 

Whenever a device requiring special user service generates an interrupt request* 
(see Chapter 4), the entire task environment becomes frozen until servicing of the 
special user interrupt is completed. All tasks will resume their former states 
when the environment Is restarted unless the user transmits a message to one of 
them by means of the . IXMT call from the interrupt service routine. In the latter 
case, rescheduling occurs when the task environment is restarted. 

If the task for which the non-zero message is intended has issued a . REC for the 
message, the task state is changed from suspended to ready even though task 
activity is in suspension. If more than one task is awaiting a message at this 
location, only one will receive the message and be readied. Contents of all 
accumulators are destroyed upon return from . IXMT, so the user is cautioned to 
restore AC2 and AC3 before attempting an exit from the service routine. 

As with . XMT (described later in this chapter), . IXMT causes a non-zero message 
to be deposited in a location. The contents of this location must be zero at the time 
. IXMT is invoked, or else the location will be deemed to be already in use. 

The format of this call Is: 

AGO - Message location. 
AC1 - Message. 

. IXMT 
error return 
normal return 
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Tran smit a Message from a User Interrupt Service Routine (.IXMT) (Continued) 

The error return is taken if the message address is already in use (i.e. » if its 
contents are non-zero). 



AC 2 Mnemonic 



43 



ERXMT 



Meaning 

Message location is in use, 



Define a Kill- Processing Address (.KILAD) 

The .KILAD task call permits a user to define a special address which will gain 
control the first time that the termination of a task, the 'target task, " is 
attempted. The second time that a termination of this task is attempted, the task 
will be terminated without control transferring to the kill-processing address. 

The kill address can be defined to provide a means of releasing system resources 
before termination occurs. Such resources as overlay areas, channels, user 
devices and user clock definitions must be released explicitly by the user. Having 
released these resources and performed any other desired functions, the task 
must then itself issue a .KILL call in order for its termination to occur. Since 
this would be the second attempt to terminate the task, termination would occur 
immediately. 

If, on the other hand, the target task decides not to terminate itself, then before 
branching out of the kill-processing routine it should issue a . KILAD call to the 
same or to a different kill-processing routine. This will ensure that if an attempt 
is made later to kill this task, it will not be killed immediately but will branch 
again to its kill- processing routine. 

Users should note that a task in a kill- processing routine is in execution at the 
highest priority. Thus such routines will retain control until they relinquish this 
control by a task state transition or by a priority level change. 

The format of the .KILAD task call is as follows; 

AGO - Address of the kill -processing routine. 

.KILAD 
normal return 

There are no error returns from this call. 
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Delete a Calling Task (. KILL) 

This command deletes the calling task*s TCB from the active queue, and places 
it in the free element TCB chain. The calling task is the only task that may be 
deleted via this command. There is no return from this call. If a kill- processing 
address has been defined for this task, then control goes to this address. Other- 
wise, control returns to the task scheduler which allocates system resources 
to the highest priority task that is ready. 

The format of this call is: 

.KILL 

There is no return from this call. Control goes to the task scheduler. 

Change the Priority of a Task (. PR!) 

This command changes the priority of the calling task. The calling task will be 
assigned the lowest position in the new priority class. That is, equal priority 
tasks receive control on a round-robin basis, and this task will be the last task 
in this priority class to be allocated CPU control by the scheduler. 

The format of this command is: 

AGO- New task priority . 

.PRI 

normal return 

There is no error return from this command. If a priority greater than 255 is 
requested, only the value in bits 8 through 15 will be accepted. 

Queue a Core-resident Task (.QTSK) 

This command periodically initiates a task and queues it for execution. If there is 
no TCB currently available for the creation of the new task, this call will be 
carried out as soon as a TCB becomes available. If two tasks are queued for 
execution at the same time of day, the higher priority task will receive control 
first. After each time that a new task is created and activated by this call, it is 
the user's responsibility to Insure that this task is killed, suspended, etc, 

AC 2 contains the starting address of a table, QTLN words long (see PARR, 
Appendix C), which describes the priority of the task, the time that Is to be 
created, etc. The following discusses the entries in this table. 
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Displacement 

1 


Mnemonic 

QPC 

QNUM 


2 
3 


QTOV 
QSH 



Q'.ieiK- -i Core- resident Task (. QTSK) (Out-muG"') 

User Task Queue Table 

Meaning 

Starting address of the task. 

Number of times to queue the task (-1 if the 

task is to be queued an unlimited number of 

times). 

Reserved for compatibility with RDOS. 

Starting hour (-1 if the task is to be queued 

immediately). 

4 QSMS Starting second in hour (reserved but unused if 

QSH=-1) 

5 QPRI Task I. D. /task priority. 

6 QRR Rerun time increments in seconds. 

7 QTLNK Same as TLNK of queued task's TCB (set by 

system). 

10 QOCH Reserved for compatibility with RDOS. 

11 QCOND Reserved for compatibility with RDOS. 

12 QLDST Reserved for compatibility with RDOS. 

Entry QPC is reserved for the starting address within the task where execution will 
commence. QNUM is an integer value describing the number of times the task 
will be queued. The task will be queued QNUM times (or without limit if QNUM=-1) 
unless the task call . DQTSK is issued. This call halts the queuing of the specified 
task, essentially bypassing the value specified by QNUM. 



Entries QSH, QSMS, and QRR all affect the time that the task will be created. QSH 
contains the hour in the day, and QSMS contains the second within that hour that 
the task will become created. If QSH contains -1, the task will be created 
immediately. QRR contains the increment in seconds between each time the task 
will be created. 

QPRI contains the task I. D. (if any) in Its left byte and task priority In its right 
byte. If a task with the same I. D. exists at the time this task Is activated, this 
task*s I. D. number will be cleared to zero. QTLNK is maintained by the system. 

With AC 2 containing a pointer to QPC of the User Task Queue Table, the calling 
sequence of this task call is: 
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Queue a Core-resident or Overlay Task (.QTSK ) (Continued) 

• QTSK 

error return 
normal return 

If the error return is taken, AC 2 will contain the following error code: 

AC 2 Mnemonic Meaning 

50 ERQTS Illegal information in Task Queue Table. 

If the error return is not taken, control returns to the task issuing the call at the 
normal return based on the task's priority; the calling task does not become 
suspended. 

Receive a Message (.REC) 

This command returns a message in AC1 that another task or interrupt service 
routine has posted by means of a transmit command, and restores the contents 
of the message location to all zeroes. Only one task at a time can receive a 
message from a given location. 

If the transmitter has not yet posted a message for the receiving task, the receiver 
becomes suspended until the message is Issued. If the message has already been 
issued and if the task has not also been suspended by some other event, control 
returns to the task scheduler. 

The format of this command is: 

AGO - Message address. 

.REC 

normal return. 

AC1 - Message. 

There is no error return from this command. 

Suspend a Task (.SUSP) 

This command places the calling task in the suspended state by setting bit 1 of the 
task's status and priority word. The format of this call is: 

. SUSP 
normal return 
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Suspend a Task (.SUSP) (Continued) 

There is no error return, The suspended task remains suspended until it is readied 
by an . ARDY or . TIDR command. 

Create a Task (.TASK) 

This command creates a new task in the user environment, and assigns to it a 
TCB from the TCB pool allocated during system generation. This command creates 
a task at a specified priority and assigns a unique identification number ( L D. ) 
to the task, if desired. When the user program is started, only one task (the 
default task) exists. Thus this command is used to start up a multitask environment. 

The new task can be assigned any priority from through 255 decimal, and any 
task I. D. in the same range. If the priority input to this command is 0, the 
priority of the caller will be assigned to the new task. More than one task with 
an I. D. of zero can exist. This call will pass to the new task the contents of the 
caller's AC2; thus this accumulator can be used for relaying an initial one-word 
message to the newly created task. 

The format of this command is: 

AGO, left byte - New task's I. D. 

AGO, right byte - New task's priority. 

AC1 - New tasK's starting address. 

AC2 - Caller's AC2 passed to the new task. 

.TASK 
error return 
normal return 

If the error return is taken, AC2 will contain one of the following error codes: 

AC2 Mnemonic Meaning 

42 ERNOT No TCB's available. 

61 ERTID Same I. D. number (except 0) already assigned. 

Kill a Task Specified by I. D. Number (. TIDK) 

This call kills only that task whose identification number is specified in AC1. 
The format of this command is: 
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Kill a Task Specified by L D. Number (. TIDK) (Continued) 

AC1 - I. D, of task to be killed. 

. TIDK 

error return 
normal return 

If the error return is taken, AC2 will contain the following error code: 

AC2 Mnemonic Meaning 

61 ERTID x\ T o task exists with this I. D. 

Change the Priority 7 of a Task Specified by LP. Number (. TIDP) 

This command changes the priority of that task whose identification is specified by 
the contents of AC1. The new priority to be assigned to the task is given hi AGO, 
bits 8 to 15. Thus the format of this task call is as follows: 

AGO, right byte - New priority. 

AC1 - I. D, of task whose priority is to be changed. 

.TIDP 

error return 
normal return 

If the error return is taken, the following code is given: 

AC2 Mnemonic Meaning 

61 ERTID No task exists with this I. D. 

Ready a Task Specified by I. D. Number (. TIDR) 

This command readies only that task whose identification number is input in AC1, 
That is, this command resets bit 1 in TPRST of this task's TCB which was set by 
a previous call to .ASUSP, .SUSP, or .TIDS. The format of this call Is: 

AC1 - I. D. of task to be readied. 

.TIDR 

error return 
normal return 
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Ready a Task Specified by L D. Number (.TIDR) (Continued) 

If the error return is taken, AC2 will contain the following error code: 

AC2 Mnemonic Meaning 

61 ERTID No task exists with this I. D. 

Suspend a Task Specified by I. D. Number (. TIPS) 

This command suspends only that task whose identification number is input in AC1, 
That is, this call sets bit 1 in word TPRST of the specified task's TCB. The format 
of this command is: 

.TIDS 

error return 
normal return 

If the error return is taken, AC2 will contain the following error code: 

AC2 Mnemonic Meaning 

61 ERTID No task exists with this I. D. 



Transmit a Message (.XMT), and Wait (.XMTW) 

These two calls permit the sending of a one-word non-zero message by one task 
to an empty (all -zero) message location for another task. The difference between 
these commands is .XMT simply causes the message to be deposited, while 
.XMTW deposits the message and suspends the caller until the message is received, 
. XMTW will not cause the caller to be suspended if a . REC has already been 
issued for this message. 

The format of this call is: 

AGO - Message address. 
AC1 - Message. 

.XMT (or .XMTW) 

error return 
normal return 
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The error return is taken if the message address is already in use (i.e. » if the 
contents are non-zero), AC 2 will then contain the following error code: 

AC 2 Mnemonic Meaning 

43 ERXMT The message address is already in use, 

115 ERXMZ Zero message word. 

Locking a Process via the . XMT/. REC Mechanism 

The .REC and .XMT commands can be used to lock and unlock a process or data 
base which is shared by several tasks, preventing more than one task at a time 
from accessing the data base or the process path. In essence, the procedure is 
to define a synchronization word, the message location, which all tasks will 
attempt to receive. The task in control of the locked resource then issues an 
, XMT to the s>mehronization word when the resource is to be made available to 
the other waiting tasks. The highest priority task waiting to receive (. REC) the 
synchronization word is then readied and gains unique control of the resource. 
This task, in turn» captures the use of the resource until it unlocks the resource 
by issuing an . XMT to the synchronization word, etc. 

This technique requires that the locking facility be initialized before any tasks 
use it. Initialization can be performed either by setting the synchronization word 
initially to a non-zero value, or by having an Initialization task issue an .XMT to 
the synchronization word. 
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CHAPTER 4 

USER INTERRUPTS AND POWER FAIL /AUTO RESTART PROCEDURES 

SERVICING USER INTERRUPTS 

User devices may be identified either at the time an RTOS system is generated 
(RTOSGEN time) or at ran time. This chapter describes the procedure for 
identifying a user device at run time, and describes the special considerations 
applying to special, high priority user interrupt devices. 

Upon detection of an interrupt request, the system will be dispatched through the 
device interrupt vector table, . ITBL . In this table are pointers to Device Control 
Tables (DCTs) for devices established at RTOSGEN time, whether system or user 
devices. Procedures for writing a device driver for insertion in the system at 
RTOSGEN time are given in DGC application note 017-000006, User Device Driver 
Implementation in the Real Time Operating System. 

In order to identify a user device to the system at run time, the user must provide 
a three -word DCT as an interface between the system interrupt dispatch routine 
and the user -interrupt servicing routine. The structure and mnemonic assignments 
of this three-word table are as follows: 

Displacement Mnemonic Purpose 

DCTSV Pointer to the state save area (an 8-word 

area). 

1 DCTMS Interrupt service mask. 

2 DCTIS Interrupt service routine address. 

DCTSV is a pointer to an eight-word state variable save area used by the system to 
store the PC, accumulators, carry, etc. DCTIS is a pointer to the routine which 
services this particular device interrupt. DCTMS is the interrupt mask* that the 
user wants to be ORed with the current interrupt mask while in the user interrupt 
service routine. This mask establishes which devices --if any- -will be able to 
interrupt the currently interrupting device. 



* See "How to Use the Nova Computers, " Section 2.4, 
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SERVICING USER INTERRUPTS (Continued; 

Upon transferring control to the user interrupt service routine, the system will 

ensure that AC3 contains the return address required for exit from the routine, 

and that AC2 contains the address of the DCT, (Caution: RDOS 4. 00 does not place ( 

die DCT address in AC2. ) Exit is accomplished by issuing task call . UCEX; 

this call mav be issued in both single and multitask environments. 

All multitask environment activity ceases at the moment a user device interrupt is 
detected. Nonetheless, it is possible for a user to communicate a message to 
a task from a service routine. If the task in question has been expecting such a 
message through issuance of a .REC and is now in the suspended state, issuance 
of the message via . 1XMT will cause that task to be readied even though multi- 
task activity is in abeyance. If no task has issued a .REC for such a message, 
. IXMT simply posts the message and takes no further action. For more information 
on communicating to tasks from a user interrupt service routine, see Chapter 3. 

Identifying User Interrupt Devices (. IDEF) 

In order to introduce to the system those devices (not identified at RTOSGEN time) 
whose interrupts the system is to recognize, the system call .IDEF must be issued. 
This call places an entry in the device interrupt vector table, . ITBL . Required 
inputs to this call are the device code of the user device and the starting address 
of this device's DCT. The format of this call is: 

AGO - Device code of the user device. 

AC1 - Starting address of the user device's DCT. 

.SYSTM 
.IDEF 

error return 
normal return 

Possible error messages are: 

AC2 Mnemonic Meaning 

36 ERDNM Illegal device code (>77g). Device code 77g is 

reserved for the power monitor/auto restart 
option. 
45 ERIBS Interrupt device code in use. 

Exit from a User Interrupt Routine (. UIEX) 

Upon a user device interrupt, AC3 will contain the return address upon entry to the 
user routine and AC2 will contain the DCT address. To return from the user 
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Exit from a User Interrupt Routine (. UIEX) (Continued) 

interrupt routine, AC3 and AC2 must be restored to the values they contained upon 
| entry to the routine, and task call, UIEX must be issued, (Caution: RDOS 04 will 

execute this call correctly without the DCT address in AC2. ) 

The format of this call is: 
AC2 - DCT address, 
ACS - Return address upon entry to routine. 

. UIEX 

Control returns to the point outside the user routine which was interrupted by the 
user device. No errors are possible from this call. This call can be issued in a 
single task environment. Rescheduling occurs only if a task state- change occurred. 

Modifying the Current Interrupt Mask (.SMSK) 

Whenever a user interrupt occurs, the interrupt mask is ORed with the mask 
contained in DC TMS of the user DCT to produce the current interrupt mask. 
Nonetheless, It is possible in the service routine to produce a current mask which 
ignores the contents of DCTMS, producing a new mask which is the logical OR of 
the old mask (upon entry to the service routine) and a new value. This is done by 
task call .SMSK, whose format is as follows: 

AGO - New value to be ORed with old mask. 
AC2 - DCT address. 

.SMSK 

normal return 

There is no error return possible from this call. This call may be issued in a 
I single task environment. (Caution: RDOS 04 will execute this call correctly without 

' the DCT address in AC2.) 

Remove User Interrupt Servicing Program (. IRMV ) 

To prevent the system's recognition of user interrupts which have been previously 

identified by the . IDEF command, the .IRMV command is issued. Required input 
to this call is the user device code corresponding to the device control table which 
is to be removed. The format of this call is: 

AGO - Device code. 

.SYSTM 
. IRMV 

error return 
normal return 
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One possible error message may be given: 

AC 2 Mnemonic Meaning 

36 ERDNM Illegal device code ( > 77 ) or attempt to remove 

a system device ( i. e. , one established at RTOSGEN 
time). 

POWER FAIL/AUTO RESTART PROCEDURES 



RTOS provides software support for the power fail/automatic restart option. Upon 
detection of a loss of power, the system transfers control to a power fail routine 
which saves the status of accumulators through 3, the PC and Carry. 

When power is restored, if the console key is in the LOCK position, the message 

**POWER FAIL** 

is output on the system console and the state variables are restored before control 
resumes operation at the point where it was interrupted. If the console key was in 
the ON position when input power failed, the user must set the console switches to 
all zeroes (down) and START must be pressed when power is restored. This causes 
the console message to be output and state variables to be restored as when the key 
is in the LOCK position. 

The following system devices are given power-up restart service; 

paper tape readers/punches 

Teletypes 

quad multiplexors 

card readers 

line printers 

disks 

Character devices may lose one or more characters during power up. Each card 

reader may lose up to 80 columns of information on a single card. Line printers 
may lose up to a single line of information. Since power up service for disks 
includes a complete re-read or re-write of the current disk block, no disk 
information is lost, although moving head disk units will require 30 to 40 seconds 
before disk operations can continue. Devices requiring operator intervention (like 
line printers, card readers, etc, ) must receive such action if power was lost for 
an extended period of time. No power up service is provided for magnetic tape 
or cassette units. 
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POWER FAIL/AUTO RESTART PROCEDURES (Continued) 

Power up service for special user devices (or for magnetic tape or cassette units) 
must be provided by the user via the system call . IDEF . To use , IDEF for this 
purpose, AGO must be input with 77g and AC1 must input the starting address of 
the user power up routine. Exit from this power up routine is accomplished by 
task call .UPEX, described below, 

Exit from a Power Fail Service Routine (. UPEX) 

Upon entering a user power fail service routine, AC3 will contain the address 
required for exit from the routine. To return from the user power fail service 
routine, AC3 must be loaded with this return address and task call .UPEX must 
be issued. 

The format of this call is: 

AC 3 - Return address upon entry to the routine. 

. UPEX 

Control returns to the location which was interrupted by a power failure. No 
error return or normal return need be reserved. .UPEX can be issued in a 
single task environment. 

HIGH PRIORITY USER INTERRUPT SERVICE 



As described in Chapter 6 and in Appendix B, special high priority interrupt 
devices may be incorporated into an RTOS system at RTOSGEN time. The real 
time clock and power fail /auto restart device are two such high priority interrupt 
devices; users may also specify custom high priority interrupt service routines. 

All high priority devices have entries in a high priority interrupt dispatch table, 
. HINT . Entries in this table are scanned whenever an interrupt occurs, and only 
if no high priority device has caused an interrupt will control branch through the 
normal interrupt table, . I TBL . All other system devices, and user devices 
announced at run time (via system call . IDEF), have entries in . ITBL . 

Interrupts are disabled whenever high priority Interrupt service is being performed, 
Users writing high priority'- interrupt service routines must also conform to several 

programming conventions, hi general, these conventions are as follows: 
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1) Issue no task or system calls, 

2) Save and restore accumulators and Carry if used by this routine. 

3) Save the contents of location 0, and place a HALT instruction in 
location (optional). 

The state of Carry and the contents of accumulators AGO through AC2 must be saved 
within this routine if they are altered in this routine, and these state variables must 
be restored before leaving the routine. AC3 is saved by the system in location . SAC 3 
(a location within module INTO), and AC3 too must be restored before exit is accom- 
plished even if the routine didn't use ACS. The contents of location will contain 
the return address needed for exit; this address should be stored in a user -provided 
location, e.g., RET , and a HALT instruction should be stored in location 0. This 
practice is adhered to by RTOS to capture program control in the event of system 
failure. 



The final two instructions which must be executed when leaving a high priority 
interrupt service routine are to enable interrupts and then to perform an indirect 
JMP to the location containing the original return PC, e.g. , RET . Control will 
then pass to the next instruction which would have been executed had no high 
priority interrupt occurred. The following instruction sequence accomplishes 
these operations. 

. EXTN .SAC 3 

; RESTORE AGO, AC1, AC2, CARRY 





LDA 3 § SAC3 




INTEN 




JMP § RET 


SAC3: 


.SAC3 


RET: 


.BLK 1 




.END 
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CHAPTER 5 

MULTIPLE PROCESSOR SYSTEMS 

MULTIPLE PROCESSOR PROGRAMMING 

All features of RTOS discussed in previous chapters are available to systems with 
two or more processors. Additional hardware support extended to multiple pro- 
cessor systems by RTOS Is in the form of a Multiprocessor Communications 
Adapter (MCA), option 4038. 

Data Transmissions 



The type 4038 Multiprocessor Communications Adapter receiver/transmitter 
(MCAR/MCAT) makes it possible for full duplex interprogram communications to 
take place, in blocks of up to 8192 bytes, via the data channel. MCA support can 
be given to a single processor in a multiple processor system so that an RTOS 
program running in one processor can communicate with an RTOS program 
running in another processor or with either a foreground or background program 
running under RDOS in another processor. Each CPU may communicate with any 
of up to 14 other CPUs. 



Each MCA line corresponds to a file name of the following form: 

MCATrmm or MCARmn 

where mm represents a receiver unit number from 1-15 inclusive and where nn 
represents a transmitter unit number in the range - 15. Thus a four -CPU, RTOS' 
only system would be logically configured with 10 separate lines if every possible 
communications link were to be used. 
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Data Transmissions (Continued) 

If CPU #1 wanted to read from CPU #3, each unit would have to issue the following 

sets of instructions: 

Unit #1 Unit #3 



. OPEN n ;OPEN MCAR:3 . OPEN n ;OPEN MCATrl 
.RDSn .WRSn 

Note that units #1 and #3 are operating under distinct operating systems. Thus, 
in the illustration on the previous page there is no correspondence between channel 
n for unit #1 and channel n for unit #3. 

If, in a receive request, unit number zero is specified to be the transmitter (e.g. , 
MCAR.-O), the receive request becomes generalized to indicate that any unit may 
transmit to this receiver. Thus if unit #1 had three outstanding receive requests, 
MCAR:4, MCAR:3, and MCAR:0, it could receive concurrent transmissions from 
three sources; a transmission unit from unit #4, a transmission from unit #3, and 
a message from any other unit that chose to transmit to it. 

A timeout can occur only in the MCA transmitter; the receiver can wait indefinitely. 
The timeout period ranges from approximately 10 milliseconds to approximately 
655 seconds. The default timeout, specified at RTOSGEN time, may be super- 
seded by specifying a different timeout both when the transmitter is opened and 
when the write sequential is issued. 

Get the Current CPU's MCA Number (. GMCA) 

It is possible to get the MCA unit number in the CPU which is currently executing a 
user program. To obtain the unit number, system call . GMCA is issued. The 
format of this command is as follows: 

.SYSTM 
. GMCA 

error return 
normal return 

If the normal return is taken, uhe MCAunit number is returned in AC1. If the error 

return is taken, the following error code will be input in AC2: 

AC2 Mnemonic Meaning 

36 ERDNM Device not in system (i. e. , no MCA was specified 

at SYSGEN time in this operating system). 
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MULTIPROCESSOR SYSTEM ILLUSTRATION 

Consider the following application for a multiprocessor system. A large labora- 
tory complex needs an automated system to control the environmental conditions 
within die complex, to keep track of the number of personnel at locations through- 
out the complex, and to monitor the complex for alarm conditions (alerting key 
personnel when a condition cannot be corrected by die system itself). Moreover, 
die system must be fail-safe, and can allow down-time for no longer than a few 
seconds. 

Such a system might well be configured along die lines suggested by the illustration 
at the end of this section. Two master CPUs, a Dual NOVA system running under 
RDOS, are connected in redundant fashion so that if one fails, die other detects 
this failure and gains immediate control. The masters access a common data base 
which contains, among other information, alarm messages and destinations to 
which they should be sent in the event of an alert. Also contained in this file space 
is a log of the current master's activity, so that if it should experience failure, 
die alternate master CPU would have a record of recent events. An IPB connects 
the masters so that they may access common disk files and so that one may act as 
a watchdog on die odier's behavior. 

There are three slave CPUs, each of which monitors and controls various para- 
meters within one zone of the building complex. Each slave is capable of monitor- 
ing and adjusting bodi die humidity' and the temperature of each zone. Additionally, 
each slave keeps track of the positions of personnel within each zone. Finally, 
each slave monitors its zone for the occurrence of alarm conditions, and it can 
perform limited response to emergencies, e.g. , it can activate a sprinkler system 
if fire is detected. The functions performed by each slave are relatively simple 
and could be performed by NOVA 2 computers running under RTOS. 

Each slave has a high speed data channel line, MCA1 through MCA6, to each of the 
two master computers, so that continuous status reports can be generated by them 
for transmission to CRT monitors via the Multiline Asynchronous Controller, MAC. 
The MAC also has direct "hot lines" to key personnel (security guards, fire 
station personnel, etc. ) who should be alerted in the event of an emergency. 



5-3 



CRT 
and 
"Hot Lines" 




Zone 1 



Zone 3 



Zone 2 



a - temperature sensing and control 

b - census taking 

c - humidity sensing and control 

d - intrusion/fire/smoke alarm and control 



Ml - Master CPU 

M2 - Back-up Master CPU 

S1,S2,S3 - Slave CPUs 



(MAC1 through MCA6 depict software lines, not physical cabling. 



MULTIPROCESSOR SYSTEM ILLUSTRATION 
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CHAPTER 6 

SYSTEM ORGANIZATION 

This chapter describes the collection of tables and fixed locations which are used by 
programs running under the real time operating system. As described in Appendix 
C, each user program supported by RTOS is loaded with an RTOS module generated 
by die RTOS GEN program, followed by user- supplied RTOS drivers and the RTOS 
system library. Loading itself is accomplished by means of the stand-alone or SOS 
extended relocatable loader or the RDOS loader. At the completion of loading, 
pointers and tables are found as illustrated in the RTOS Core Map shown on the 
following page. 

RTOS Page Zero 

Locations through 15 are reserved for use by the system and cannot be taken 
by user programs. Location receives the current PC upon each interrupt, and 
location 1 contains a pointer to the system interrupt dispatch logic. This is usually 
either . HINT, the high priority interrupt dispatcher, or . INTP, the regular interrupt 
processor. These modules are produced by RTOS GEN. 

When a task in RTOS is in the executing state, the CPU is said to be in User Mode. 

Otherwise (as when RTOS is engaged in some system function like task scheduling) 
the CPU is said to be in System Mode. Location 5, .SYS. » is a flag which is set 
to zero when the system is in User Mode, and is set to non-zero in System Mode. 
Interrupts in a real-time environment occur randomly. Since it is inappropriate 
for certain interrupt -triggered system functions to be reentrant (e.g. » task 
scheduling) .SYS. serves as an interlock to prevent undesired entries into these 
routines. 

Location 2, BEGIN, contains a pointer to the RTOS initialization program. This 

program is used to initialize stacks and clear switches in RTOS. The first section 
of this routine zeroes system switches and intializes all device handlers. The 
starting task is initially set to a priority 7 of zero, the hardware interrupt mask is 
made zero, the system is set in User Mode (.SYS. = 0), the real time clock is 
started, and TCB chain pointers are initialized. The wait character logic, 
activated by .WCHAR, is also reset. 



The last operations performed by the initialization program are to enable the 
interrupt facility by the INTEN instruction, and to jump to the start of the user 
program (which must have been specified in an . END statement). 
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R TOS C o re Map 



je Zero 



1 


2 BEGIN 


3 CTCB 


4 SCHED 


5 .SYS. 


6 RLOC 


7 IGEND 


10 .CMSK 


11 DISMISS 


12 ITSTP 


13 TUNIC 


14 RSCHD 


15 .TSAVE 


16 USP 


17 


20 


Page One 



400 UST 
426 

440 

.TCBP 
. UFPT 

. DTBL 

.PTBL 

. QTBL 

.MCTB 

. HINT 

. ITBL 
. ETBL 
. CHTB 



Contents 
Interrupt service routine address. 
Starting address for system initializer. 
Address of currently executing task's TCB, 
Entry point to task scheduler. 
System mode indicator. 

Page zero temporary. 

Entry point to I/O end processor. 

Current system interrupt mask. 

Interrupt dismissal address. 

Reserved for RDOS/RTOS compatibility; set to 400. 

Entry point to routine linking ready TCB to TCB chain. 

Entry point to reschedule the system. 

Address of TCB state save routine. 

User Stack Pointer (USP). 

Entry point to system call processor. 

First page zero location available to user program. 



Start of User Status Table. 

End of User Status Table. 

Beginning of NREL area into which RTOS and user modules may be loaded. 
Trhe following global syiribols may be present in the RTOS modules: 

Start of TCB pool (total iengdi = no. of TCBs*12 ]n ). 

Start of User File Pointers Table, UFPT (total length = no. of channels dig 

Start of fixed head disk table, DTBL (total length = 1 + Shiuinber of disk 
files defined at RTOSGEN time). 

Start of moving head disk table, PTBL (total length = 1 + 6 "number of disk 
files defined at RTOSGEN time). 



Start of 4060 asynchronous multiplexor (QTY) table, QTBL (total length 

tlon Adapter line table, (total length 



= 10 *number of QTY lines) 



Start of Multiprocessor Commu 
= 7 + number of adapters in the 

Start of high priority- dispatches 
priority interrupt devices). 

Start of interrupt table, ITBL ((• 

End (last location) of ITBL (usee 

Start of device name table, CIV 

User program with user device 

RTOS device drivers. 

RTOS system library' modules. 



lumber of high 

, If present). 

doer of devices in system) 
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RTQS Page Zero (Continued) 

Location 3, CTCB* contains the TCB address of the currently executing task. Location 
4, SCHED, points to the main entry in the task scheduler. This entry causes the 
highest priority ready task (if any) to be executed. Location 14, RSCIO, cT~:ts to 
an alternate entry in the scheduler. This entry links the currently executing task's 
TCB to the ready chain, then transfers control to the entry pointed to by SCHED , 

Location 6, RLOC, is a temporary location used by RTOS; location 7, IOEND, is 
the entry point to the I/O end processor module. This routine is used to handle the 
end of I/O operations for a device handler at either the interrupt or system level. 
If while in this routine it is determined that another request is pending, the routine 
will cause the next I/O .operation on the device to be started. . CMSK, location 10, 
contains the current system interrupt mask. 

DISMISS, location 11, contains the interrupt dismissal routine address, USTP, 
location 12, is reserved for use by RTOS FORTRAN, and points to the start of the 
User Status Table (location 400). The value "0400" is also equivalent to a "JMP . " 
instruction, so RTOS transfers control to this location whenever a system panic is 
detected. System panics result from unknown system errors and are generally 
unrecoverable; restarting at location 376 will restart the system provided the RTOS 
program has not been damaged. 

Location 13, TLINK, points to a routine which links a ready TCB to the ready chain. 
Tills routine is entered by the system whenever a task is raised to the ready state. 
RSCHD, location 14, contains the entry point to the task scheduler which links the 
current TCB to the ready chain, then executes the highest priority ready task. 
Location 15, . TSAVE, contains the address of the TCB state save routine. 

Location 16 contains the User Stack Pointer, USP, This location is used by certain 
high-level languages, among them FORTRAN IV, and is loaded into ACS by RTOS 
on return from system or task calls. * AC3 is destroyed whenever any such call is 

issued, since it is equivalent to a JSR instruction. On return from a call however, 
AC3 is loaded with the contents ofTjSP. * Thus on NOVA systems and ECLIPSE 
systems with TMIN, a convenient method of saving AC3 before Issuing a call is to 
first save AC3 in USP. AC3 will then be restored by the system upon returning from 
the call. Furthermore, since USP is saved in the TCB as part of the state of a task 
in execution, It may be used as the equivalent of an extra register by tasks without 
stacks. 



♦Unless RTOS is running on an ECLIPSE computer with BTMIN. See Chapter 1, 

System and Task Call Formats . 
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User Status Table (UST) 

The User Status Table (UST) is found at the start of NREL memory. This table is 

27 words long, and contains information pertaining to the status of the user program. 

8 
Unused words within the US.' are set to -1, The structure of the UST is as follows: 



Displacement 


Mnemonic 





USTPC 


1 


USTZM 


2 


USTSS 


3 


USTES 


4 


USTNM 


5 


USTSA 


6 


USTDA 


7 


USTHU 


10 


USTCS 


11 


UST IT 


12 


USTBR 


13 


USTCH 



14 



USTCT 



15 


USTAC 


16 


USTFC 


17 


USTIN 


20 


USTOD 


21 


USTSV 


22 


USTSQ 


23 


USTXQ 


24 


USTPQ 


25 


USTOS 


26 


USTNA 



Contents 

Maintained for RDOS compatibility only. 
ZMAX, the lowest unused ZREL memory location. 
The start of the symbol table. 

The end of the symbol table (i.e. » its lowest core 
address). 

NMAX, the lowest unused NREL memory location. 
The user program starting address. 
The address of the debugger. 

The highest address occupied by the user program 
and RTOS upon completion of loading. 
FORTRAN common area size. 
Maintained for RDOS compatibility only. 
Maintained for RDOS compatibility only. 
Number of tasks (left half), number of channels 
right half). 

TCB address of the first user task to execute after 
RTOS initialization. 
Start of ready TCB queue. 
Start of the free (dormant) TCB chain. 
Start of user NREL program (set by the loader). 
Reserved only for compatibility with RDOS. 
Reserved for compatibility with RDOS. 
Start of suspended TCB queue. 
Start of the . XMTW/. REC queue. 
Start of internal system queue of tasks being ser- 
viced (i.e. » TCBs returning to base level after I/O). 
Scheduler idle counter (used in checking $PTR 
timeouts). 
Number of active tasks (TCBs in use). 



The last word in the UST is also assigned the mnemonic USTEN. 
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Task Control Block (TCB) Pool 

Given the asynchronous nature of tasks, the RTOS Task Scheduler must maintain 
certain status information about each task. This information is retained within 
a table called a Task Control Block (TCB), and there is one TCB for each task. 
All TCBs are found in a series or pool following the User Status Table, TCBs 
constructed for programs run on a NOVA computer are shorter by four words 
than TCBs for programs run on an ECLIPSE computer. The following illustration 
describes the structure of all TCBs: 



Displacement 


Mnemonic 





TPC 


1 


TACO 


2 


TAC1 


3 


TAC2 


4 


TAG 3 


5 


TPRST 


6 


TSYS 


7 


TLNK 


10 


TUSP 


11 


TELN 


12 


TID 


13 


TTMP 


14 


TKLAD 


15 


TSP 


16 


TFP 


17 


TSL 


20 


TSO 



Contents 

Carry in bit 0, PC in bits 1-15. 

AGO 

AC1 

AC 2 

AC 3 

Task status and priority. 

System call word. 

TCB link word (-1 if last TCB in the queue). 

Task USP. 

FORTRAN IV variables save area address. 

Task identifier. 

Used to service . ABORT calls. 

Task kill address. 

Stack pointer (ECLIPSE computer only). 

Frame pointer (ECLIPSE computer only). 

Stack limit (ECLIPSE computer only). 

Overflow address (ECLIPSE computer only). 



Word 5, the task status and priority, contains information describing the state of the 
task, its priority, and whether it has any outstanding message transmit or receive 
request: 



TPRST: 











priority 



1 2 



15 



Bit is set to a 1 if the task is suspended due to an outstanding system call. Bit 1 
is set to 1 if the task is suspended due to task calls . SUSP, . ASUSP, or .TIDS. Bit 
2 is set to a 1 only if the task is suspended due to outstanding task calls . XMTW 
or . REC. The task priority is contained in bits 9-15. 
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Word 6, TSYS, Is used by RTOS in executing system calls. Word 7 contains the 

starting address of the next TCB in the queue (the last TCB in a queue has a link of 
-1), Word 12, T!D» contains the task's 8-bit identifier in bits 9-15. 

TKLAD contains the address which is to receive control upon a task's being killed, 
if such an address has been defined via a , KILAD call, The remaining four words 
contain stack state save information which is relevant only for ECLIPSE machines. 
Nonetheless, these words are reserved for TCBs in all single task programs so 
that programs such as utilities can be run on both the NOVA and ECLIPSE computers, 

User File Pointers Table (.UFPT) 



Following the TCB pool is a table called the User File Pointers Table (.UFPT). The 
purpose of this table is to indicate what device or file is open on which RTOS 
channels. The .UFPT consists of a series of two-word frames, one for each 
channel defined for the RTOS system at RTOSGEN time. The first frame represents 
the device (or file) opened on channel zero, etc. 

The two-word frame will contain one of two sets of information, depending upon 
whether it is a single- or multi-file device which is opened on the designated 
channel. Frames for all devices contain the device DCT address in displacement 
0. Displacement 1 for single-file device frames is unspecified. Displacement 1 
of multi-file device frames, however, contains a pointer to a frame within a device 
file table or within a device driver itself. ' Device file tables are discussed in the 
following section. Frames within device file tables describe disk files, QTY lines, 
or MCA units. Frames for cassettes and magnetic tape units point to unit control 
tables for these units. 

Device File Tables 

One or more device file tables may follow the .UFPT. The following devices have 
special device tables and have no entries in the standard device name table (,CHTB» 
to be discussed later): 



Device 


Table Name 


fixed head disk 


.DTBL 


moving head disk 


. PTBL 


asynchronous mux 


.QTBL 


Multiprocessor Communications 


. MCTB 


Adapter 
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Device File Tables (Continued) 

Device 

magnetic tape 
cassette 



Table Name 

. MTUn 
, CTUn 



The device file table established for fixed head disks is composed of a series of 
five-word frames, one for each file defined at RTOSGEN time. Each frame 
contains the name of the file and its contiguous disk block address boundaries. This 
approach allows four-, five-, or six-character file names to be given to each disk, 
fully compatible with contiguous disk files as defined in the real time disk 
operating system, RDOS. Each frame in . DTBL has the following structure: 



. DTBL frame 



Displacement 
0-2 

3 

4 



Contents 

File name, left justified, trailing null 

bytes. 

Starting disk block address. 

Ending disk block address. 



The device file table for moving head disks (cartridge or pack) is similar to . DTBL, 
but has one additional entry to describe the drive unit number: 



. PTBL frame 



Displacement 


1-3 

4 
5 



Contents 

Drive unit number. 

File name, left justified, trailing null 

bytes. 

Starting disk block address. 

Ending disk block address. 



The 4060 asynchronous multiplexor driver (QTY) device table is named .QTBL . 
This table consists of a series of ten-word frames with one frame reserved for each 
QTY line; the first frame corresponds to line number 0, the second frame corres- 
ponds to line number 1, etc. Each frame in .QTBL has the following structure: 
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Device File Tables (Continued) 



QTBL frame ( 



Contents 

Bit zero set if not opened; line number if 

open. 

Receive byte pointer. 

Transmit byte pointer. 

Read request TCB address. 

Write request TCB address. 

Read sequential limit; if read line. 

Write sequential limit; -1 if finished 

writing; if write line. 

Character hold for echo during read line. 

Line feed insertion flag (non-zero for 

insertions). 

Device characteristics: 

DCKEY echo characters 
DCPCK parity check/generation 

DC LAC line feeds after carriage 
returns. 

The device file table for MCA lines is named . MCTB . This table consists of a 

series of seven-word frames, each frame reserved for an MCA unit' number; each 
MCA line connects two MCA units (a transmitter and a receiver). Hie total 
number of frames equals two times the number of lines defined at RTOSGEN time 
plus one (for unit number zero reception requests). The first frame corresponds 
to unit number zero, etc. Each frame in .MCTB has the following structure: 



Displacement 

r 

1 
2 
3 
4 
5 
6 

7 
10 

11 



v 



Displacement 



s 



. MCTB 
frame 



v 



Contents 

List link. 
Word count. 

Current address. 

Device code of the adapter at the other end 

of the line; code is positioned as in the 

MCA status words. 

Error retry count. 

TCB address of task issuing the read or 

write request; -1 if no task is issuing 

such a request. This word is set to zero 

if the line is closed. 

Device retry specification input in AC1 to 

. OPEN . 
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Device File Tables (Continued) 

Line table entries are linked via displacement of each frame, Entries in the chain 
correspond to MCA units which have MCA transmit or receive requests outstanding. 

There are two kinds of unit control tables (UCTs) for magnetic tape and cassette 
units, A truncated UCT is employed for units which will use only direct or unbuffered 
I/O, and a standard UCT is used for units which are to utilize both unbuffered and 
buffered I/O. 

Each standard UCT is found in a module entitled MTUn or CTUn. Each of these 
modules contains a standard UCT followed by an octal 401 word buffer. If 
unbuffered I/O is specified at RTOSGEN time, a module entitled SMTU or (SCTU 
for cassettes) is loaded which contains 8 truncated UCTs, one for each possible tape 
unit. 

Each UCT has the structure described below; truncated UCTs contain only the first 
three words of this structure: 



Displacement 


1 



2 

3 

4 

5 

6 

7 

10 

11 

12 



Contents 

Current file number. 
Status of unit: 

+1: release of tape unit is in progress. 
0: unit is not initialized. 

-1: unit is initialized. 

-2: initialization of unit is in progress. 
Unit number of this UCT (truncated UCT ends here). 
First byte address of buffer. 
Size of buffer in bytes. 
Input buffer byte pointer. 
Output buffer byte pointer. 
Number of bytes to be read. 
Number of bytes written. 
Pointer into user data area. 
Counter governing user data area. 



6-9 



High Priority interrupt Table (.HINT) 

If any high priority interrupt devices were defined during system generation, one 
of two high priority interrupt dispatch tables will be loaded, If only the power fail/ 
auto restart option was selected in the RTOS system, a truncated high priority 
interrupt dispatcher will be placed after the last device file table; otherwise, the 
full high priority interrupt dispatcher, .HINT, will be placed there. These 
dispatch routines are illustrated on the following page. In essence, the operation 
of .HINT is as follows. Each high priority interrupt device is examined to see if 
it generated the interrupt. The power fail monitor is tested first, then the real 
time clock, and then each of the other devices specified at RTOSGEN time in the 
order that they were specified during system generation. If the source of the 
interrupt is found, control is dispatched to its interrupt service routine; otherwise* 
control is given to the ordinary interrupt dispatcher. 



The format of the high priority interrupt dispatcher is as follows: 



SKPDZ CPU ; 


JMP § A ; 


STA 3@ B ; 


INTA 3 ; 


SKPDZ RTC ; 


JMP @ C ; 


SKPDZ device i ; 


JMP @ D ; 


SKPDZ device n 


JMP @ N ; 


JMP@.+1 ; 


. INTO ; 


.SAC 3 


PWRIS ; 


RTCIS ; 


DV1IS ; 



CHECK FOR POWER FAIL INTERRUPT 

YES. GO TO POWER FAIL INTERRUPT SERVICE, 

OTHERWISE, SAVE 3 

AND GET INTERRUPT DEVICE CODE. 

WAS IT THE REAL TIME CLOCK? 

YES. GO TO RTC INTERRUPT SERVICE 

WAS IT DEVICE 1? 

YES. GO TO DEVICE 1 INTERRUPT SERVICE 

ETC. 



GO TO DEVICE N INTERRUPT SERVICE, BUT IF 

NO HIGH PRIORITY DEVICE INTERRUPT 

GO TO ORDINARY INTERRUPT DISPATCH ROUTINE 

POWER FAIL INTERRUPT SERVICE ADDRESS 
RTC INTERRUPT SERVICE ADDRESS 
DEVICE 1 INTERRUPT SERVICE 



N: 



DVNIS 



; DEVICE N INTERRUPT SERVICE. 
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High Priority Interrupt Table (. HINT) (Continued) 



The power fail - only interrupt dispatcher looks like the following: 

SKPDZ CPU ; POWER FAIL INTERRUPT? 

JMP @ ,+3 ; YES. GO TO POWER FAIL SERVICE 

JMP § .+1 ; NO, GO TO ORDINARY INTERRUPT DISPATCHER 

. 1NTP 

PWRIS ; POWER FAIL INTERRUPT SERVICE ROUTINE 

Interrupt Table (. ITBL) 

One table which Is always loaded is the interrupt table, . ITBL . , ITBL is a 64jq- 
word table which has 64 one -word frames, one for every possible device code, 
The first entry in the table corresponds to device code zero, the second entry 
corresponds to device code 1, etc. Table entries corresponding to devices in the 
system will contain the address of that device's Device Control Table (DCT). Move- 
over, if the device is a system device, bit zero of this entry will be set to one; if 
the device is a user device, bit zero will be reset to zero. 

The last entry in this table, the entry for device code 77g, is named . ETBL. This 
entry is reserved for a user power fail/auto restart handler address. 

System devices will be initialized by the RTOS initialization program .RTOS. No 
such initialization is performed for user devices. User device drivers must perform 
their own initialization. 

Standard Device Name Table (. CHTB ) 

The last RTOS table which may be loaded is the name table, . CHTB. This is a 
table containing entries for single -file devices like the teletypewriter, paper tape 
reader /punch, card reader, line printer, and plotter. This table is built at system 
generation time, and consists of a series of four -word frames. 

Device entries are listed In this table in the order that the devices are found in 
. ITBL (i.e. , order is by ascending device code). The first three words of each 
frame contain the system name for the device, left justified and with trailing 
nulls. The fourth word in each frame contains the base address of the device's 
DCT. .CHTB is terminated with a -1. 
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Standard Device Name Table (. CHTB) (Continued) 



Thus a typical .CHTB would have the following structure: 



$ 


T 


T 


I 


null 


null 


TTIDC 


$ 


T 


T 


O 


null 


null 


TTODC 







/\ 







$ 


L 


p 


T 


1 


null 


LPT1DC 


-1 
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Call 



AGO 



APPENDIX A 



RTOS COMMAND SUMMARY 



AC1 



AC2 



. ABORT 




I.D. of task to be aborted. 




.AKILL (1) 


Priority of tasks to be killed. 






. SYSTM 
. APPEND n 


Byte pointer to device name. 


Device characteristics mask 
(see .OPEN). 


Channel number (if n = 77). 


.ARDY (1) 


Priority of tasks to be readied. 






.ASUSP^ 


Priority of tasks to be suspended. 






. SYSTM 
.CLOSE n 






Channel number (if n = 77). 


. SYSTM ! 
.DELAY j 








. DQTSK ; 




I. D. of task to be dequeued. 




. SYSTM j | Number of RTC ticks. 
.DUCLK |j 


Address of user interrupt 
routine. 




(2) I 
. SYSTM j j 

.ERTN 1 




Data word to be placed in 
AC2. 


.SYSTM | bits 9-15: character. 
.GCHAR j bits 0-8: clear. 






.SYSTM 1 
. GCHN I ] 




(returned) 

Free channel number 



(1) No error return. 

(2) No normal return. 
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Call 
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ACi 



AC2 



| 1 1 (returned) 
1 .SYSTM 1| Day. 


(returned) 
M on tli. 


(returned) 

--. 


1 || 2 

3 

II 4 

I 5 


no RTC, 
10 HZ. 
100 HZ. 

1000 HZ. 

60 HZ (line frequency) 

50 HZ (line frequency) 




# 


.SYSTM 

. GMCA 




(returned) 
Unit number. 




•SYSTM 

. GTOD 


0\jturr._d < 
Second. 


(returned) 
Minute. 


(returned) 

Hour (using a 24 -hr clock). 


. SYSTM 

. IDEF i 


Device code. 


DCT. 




• IDST 


; (returned) 
! 0: ready. 
; 1: suspended by .SYSTM call. 

2: suspended by .SUSP, .TIDS, 
> . ASUSP. 

3: waiting for .XMTW/.REC . 
; 4: not used. 
'■ 5: suspended by .SUSP, ASUSP, or 

.TIDS and .SYSTM call. 
; 6: suspended by .XMTW/.REC and 

.SUSP, ASUSP, or .TIDS 
i 7: not used. 
: 10: killed. 


bits 8-15: task I. D. number. 


i 


• SYSTM Byte pointer to device name. 
. INIT 


-1: Ml init. 
0: partial init. 


i 


.SYSTM Device code. 
. IRMV 






. 1XMT 1 1 Message address. 


Message (non-zero). 
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Call 
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AC1 



AC 2 



.KILAD jj 


Kill-processing address. 






.kill'- 






.8Y8IM |j 


HMA 


NMAX 




.MEM jj 












(returned) 




.SYSTM jj 


NMAX increment or decrement 


New NMAX (after change). 




,MEMI |j 


(2's complement). 












Channel number (if n=77). 


.SYSTM ! 


Core data address, if a data 


bit 0: 1, even parity; 


(Status word or system error 


.MTDIOr 


transfer. 


0, odd parity. 


code if error return; status 
word if read status normal 






bits 1-3: 


return. ) 






read (words) 


1B0: error. 






1 rewind tape. 


181: data late. 






3 space forward. 


1B2: tape rewinding. 






4 space backward. 


1B3: illegal command. 






5 write (words). 


1B4: high density or cassette 






6 write EOF. 


if 1; low density if 0. 






7 read device 


IBS: parity 7 error. 






status word. 


1B6: end of tape. 






bits 4-15: 


1B7: end of file. 






word or record count. 


1B8: tape at load point. 






If on space command, 


1B9: 9 -track or cassette if 






position tape to new file. 


1; 7 -track if 0. 
1B10: bad tape; write failure. 
1B11: send clock (0 if cassette) 
1B12: first character 

(0 if cassette). 
1B13: write -protected or 

write -locked 
1B14: odd character (0 if 

cassette). 




. 




1B15: unit ready. 


.SYSTM ! 


3yte pointer to tape 


Characteristic inhibit 


Channel number (if n = 77). 


.MTOPDr 


file specifier. 


mask (see . OPEN). 




.SYSTM 


Byte pointer to file name 


1B1: 80 -column device 


Channel number (if n = 77). 


.OPENn 




1B2: lower -to -upper case 








ASCII. 
1B3: form feed on open. 
1B4: full word device. 

(continued on next page) 





(1) no error return 

(2) no normal return 
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Call 
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AC1 



AC2 



1 -r- * '"*'* TYp 1 1 


IBS: LF after CR. 

1B7: par ity check/ 

generation. 
1B8; rubout after tab. 
1B9: null alter FF. 
1B10: keyboard input. 
1B11: TTY output device. 
1B12: no FF hardware. 
1B14: no TAB hardware. 
1B15: leader /trailer. 
("01" if user-specified 
MCAT timeout). 




.SYSTM [1 bits 9-15; character 
. PCHAR 1 1 






. PRI || bits 8-15: new task priority. 






. QTSK 1 j 




Task Queue Table address. 


.SYSTM I 
.RDBn 1 


i Starting core address to 
1 receive data. 


Starting disk relative block 
number. 


bits 0-7: number of blocks 

to be read. '^ 
bits 8-15: channel number 
(if n = 77). < 2 ^ 


.SYSTM 
.RDLn 


Byte pointer to user core area. 


Read byte count (including 
terminator) at end of read. 


Channel number (if n = 77). 


.SYSTM i 
. RDS n I 


j Byte pointer to core buffer. 
' (even for MCA) 

; 


Number of bytes to be read 
(if EOF detected, partial' 
byte count returned). 


Channel number (if n = 77). 


.REC ii Message address. 


Message. 




.SYSTM !| 
.RESET || 






• SYS'TM lj Byte pointer to device name. 
.RLSE |j 






(3) 1 1 
.SYSTM j 

.RTN || 







(1) no error return 

(2) if error EREOF, error code in bits 8-15, partial read count in bits 0-7. 

(3) no normal return 
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AC1 



AC2 



.SYSTM 
.RUCLK 



.SYSTM 

, SDAY 



Day, 



Month. 



Year, 



. SMSK 



New interrupt mask to be ORed 
with old mask. 



DCT address 



.SYSTM Second. 

■ STOD 



Minute. 



Hour. 



.SUSP 



,(1) 



TASK i bits 0-7: task I.D. 

[\ bits 8-15: task priority. 



New task entry point 
address 



Message to new task. 



TIDK 



TIDP 



bits 8-15: task LD. number. 



bits 8-15: task LD. number. 



TIDE. 



TIDS 



bits 8-15: task I.D. number. 



bits 8-15: task I. D. number. 



1J!?)(3) 



Any non-zero value if 
rescheduling is to occur. 



.U 



W m 



,m™ 



Any non-zero value if 
rescheduling is to occur. 



Any non-zero value if 
rescheduling is to occur. 



DCT address 



(1) no error return. 

(2) no normal return. 

(3) return address is in AC3. 
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.SYSTM 
.WCHAR 


1 -1, terminate wait request. 
| bits 9-15: wait character. 


Device code of keyboard 
transmitting the wait char- 
acter or -1 if wait request 
terminated . 




.SYSTM 

.WRBn 


! Starting core address. 


Starting relative block 
number. 


* 
bits 0-7: number of disk 

blocks, 
bits 8-18: channel number 
(if n = 77). 


.SYSTM 
.WRLn 


i Byte pointer to core buffer. 

\ 


Write byte count, including 
terminator, returned at end 

of write. 


Channel number (if n = 77). 


.SYSTM J Byte pointer to core buffer. 
.WRSn | 

i 

i 

l! 


Number of bytes to be 
written. 


right byte: channel number 
(if n = 77). 

left byte: # of MCA retries 
(each retry takes 
200 milliseconds). 


. XMT ; Message address. 


Message (non-zero). 




1 1 
. XMTW 1 1 Message address. 


Message (non-zero). 
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ERROR MESSAGE SUMMARY 



Code 



6 
12 

15 

21 

22 
23 



Mnemonic 


Meaning 


Applicable Com 


mauds 


ERFNO 


Illegal channel 


.APPEND 


.CLOSE 


. OPEN 




number. 


. MTOPD 


.MTDIO 


.RDB 






,RDL 


.RDR 


,RDS 






.WRB 


.WRL 


.WRS 


ERFNM 


Elegal file 
name. 


. OPEN 


. MTOPD 


. INIT 


ERICM 


Illegal system 


.RLSE 


. INIT 


•DELAY 




command. 


.RE NAM 
. CRAND 


.DELET 
. CCONT 


. GREAT 


ERICD 


Illegal command 


.RDS 


.WRS 


.RDL 




for device. 


.WRL 

. MTDIO 


.RDB 
. GMCA 


.WRB 


EREOF 


End of file. 


.RDB 


.RDL 




ERDLE 


Attempt to refer 
to a non-existent 
file or device. 


. OPEN 


.MTOPD 




ERFOP 


Attempt to refer- 


.RDS 


.WRL 


.RDL 




ence an unopened 


.WRS 


.CLOSE 


.MTDIO 




file or device. 


.RDB 


.WRB 




ERUFT 


Attempt to use a 
channel which is 
already in use. 


.APPEND 
. MTOPD 


. GCHN 


. OPEN 


ERLLI 


Line limit exceeded. 


.RDL 


.WRL 




ERRTN 


Attempt to return 


. RTN 


. ERTN 





(.RTN/. ERTN) from 
current program. 



24 


ERPAR 


Parity on read line. 


.RDL 


26 


ERMEM 


Not enough memory 
available. 


.MEMI 


27 


ERSPC 


Out of disk space. 


. v, RB 


30 


ERFIL 


File read error. 


.RDS 


31 


ERSEL 


Unit improperly 
selected. 


. INIT 



RDL 



OPEN 



RDS 



. MTDIO 

.MTOPD 
.RLSE 
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Code Mnemonic Meaning 



Applicable Commands 



36 


ERDNM 


Device not in sys- 
tem, or illegal 
device code. 


.INIT 
.IDEF 


.RLSE 

.CMC A 


.IRMV 

. STMAP 


41 


ERTIM 


Attempt to set 
illegal time or 
date. 


. STOD 


. SDAY 




42 


ERNOT 


Out of TCBs. 


. TASK 






43 


ERXMT 


Message address 
already in use. 


.DCMT 


.XMT 


.XMTW 


45 


ERIBS 


Device code already 
in system. 


.DUCLK 


.IDEF 


. INIT 


47 


ERSIM 


Simultaneous read or 
write attempt on 
same QTY line. 


.RDL 
.WRS 


.RDS 
.WCHAR 


.WRL 


• 50 


ERQTS 


Bad information in 
Task Queue Table. 


.QTSK 






60 


ERFIU 


Attempt to open a 
busy MCA unit. 


.OPEN 






61 
1 


ERTID 


Task I. D. error. 


.TASK 

.TIDS 

.DQTSK 


.TIDK 
.TIDP 


.TIDR 
. ABORT 


101 


ERDTO 


Device timeout. 


.WRS 






103 


ERMCA 


No complementary 
MCA request. 


.RDS 


.WRS 




104 


ERSRR 


Short MCA receive 
request. 


.RDS 


.WRL 


.WRS 


106 


ERCLO 


Channel closed by 
another task. 


.RDL 

.WRS 


.RDS 


.WRL 


110 


ERABT 


Task not abortable. 


. ABORT 






113 


ERNMC 


No MCA receive 
request. 


.WRS 






115 


ERXMZ 


Attempt to trans- 
mit a zero mes- 

age word, 

* # * * * 


.XMT 


.XMTW 


. IXMT 
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APPENDIX B 
GENERATING AND LOADING AN RTOS SYSTEM 

•.)EE T N T ~in:: r- : 7T\vs 

This appendix details the steps to be followed when creating an RTOS system tailored 
to a specific device /core configuration and to the channel/task environment of the real 
time program which will be supported by the system and user program, both in a disk 
and in a non-disk environment. 

System generation is the procedure followed to produce a relocatable binary which 
will trigger the loading of appropriate device drivers from the RTOS library, allo- 
cate tables and control blocks used by the system, and allocate a fixed number of 
channels and task control blocks. The system generation program, RTOSGEN, 
produces a relocatable binary with the default name RTOS. RB, by issuing a series 
of questions about the hardware configuration and the task/channel requirements of 
the user program. 

System loading is the procedure followed to load the system generation relocatable 
binary, user drivers if any, user relocatable binaries, and the RTOS library. 
System loading is accomplished by using a relocatable loader. 

PREPARATION FOR SYSTEM GENERATION 



If the system is configured with either a type 4048 or type 4057 moving head disk 
pack drive, it is necessary to format the disk pack using the appropriate formatter 
program before system generation is attempted. In general, all disk packs that 
are to be used in the system must be formatted prior to their use. Note that it is 
not necessary to format the disk cartridges used in a type 4047 disk drive. The 
disk pack formatter programs are stand-alone programs. The appropriate formatter 
programs and their associated manuals are listed below: 

Disk Pack Drive Formatter Program Manual 

Type 4048 095-000072 096-000039 

Type 4057 095-000071 096-000038 

SYSTEM GENERATION 

The following page contains lists of tapes required to generate and load a system in 
stand-alone and RDOS environments, To generate an RTOS program under the 
Stand-alone Operating System (SOS), the RTOSGEN program itself must be con- 
figured with appropriate device support before it can be used. Consult the Stand - 
alone Operating System User's Manual, 093-000062, for the procedures to be 
followed to configure and load SOS programs. 
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(To be supplied in an addendum to this manual) 



List of Tapes for System Generation and System Loading 
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L<>.v'l"4 RTOSGEN in 2 SOS <>r Stand -■•v," w - Twin 'W^o : 

RTOSGEN is provided as a stand-alone program on paper tape for users wishing 
to perform RTOS system generations without the support of RDOS. Standard 
binary load procedures, described in section 2, 8 of How to Use the Nova 
Computers , must be followed to load either the stand -alone RTOSGEN program 
or RTOSGEN run under SOS. 

Loading RTOSGEN in an RDOS Environment 

RTOSGEN is provided as a save file on paper tape for users wishing to perform a 
system generation on an RDOS system. To load this save file, mount tape number 
088-000082 in the reader, and type the following command to the CLI: 

The system will respond: 

LOAD {!^r}» STRIKE ANY KEY. 

Load the reader with the dump tape and strike any console key. The tape will be 
read, and the teletype will respond: 

RTOSGEN. SV 

Producing the RTOS Module 

You are now ready to begin executing RTOSGEN. This program configures the 
system by interrogating you as to the hardware characteristics and channel/task 
requirements of your program. If RTOSGEN is loaded using binary load procedures, 
it will self-start, hi an RDOS system, type the command 

RTOSGEN ) 

to invoke the program. 

Hie system generation program now outputs the message: 

RTOS SYSTEM GENERATION 

and proceeds to issue a series of questions requiring operator keyboard responses. 
An improper reply to an RTOSGEN question causes the question to be repeated. 
The questions are given and responded to in die following order unless stated 
otherwise. 
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Producing the RTQS Module (Continued) 

1. CORE STORAGE (IN K WORDS) 

Respond with any number from 4 (4K) to 32 (32K) in increments of 2 (2K), and 

follow this and all other responses with a carriage return. 

2. RTC FREQ (0=NONE, 1=10HZ, 2=':jOHZ, 3=1000HZ, 4= LINE) 

Respond wind 0, 1,2, 3, or 4 as appropriate. If you give a non-zero response, 
the system will maintain the system clock and calendar. You are cautioned to 
select the lowest acceptable frequency, since higher clock frequencies increase 
system overhead. If die line frequency is requested, RTOS asks question 3; 
otherwise, it steps to question 4. 

3. LINE FREQ (0=50HZ, 1=60HZ) 

Select or 1 as appropriate. RTOSGEN now goes to question 4. 

4. TASKS (1-255) ? 

Respond with a decimal integer from 1 through 255 corresponding to the number 
of tasks required by your program which will be loaded with die RTOS module. 
If you select one task, die minimum task scheduler, TMIN, will be loaded from 
die RTOS library; otherwise the multitask scheduler, TCBMON, will be loaded. 

5. CHANNELS (1-63) ? 

Respond with a decimal integer from 1 dirough 63, corresponding to the number 
of simultaneously open channels required by your program. 

After you have answered questions 1 dirough 5, RTOSGEN responds: 

RESPOND WITH NUMBER OF UNITS 

RTOSGEN now continues with a series of questions concerning peripheral 
support given to your program. 

6. DSK (0-1) ? (fixed head disks) 

If you respond "0", the program steps to die next question; a response of "1" 
prompts the following series of questions: 

DISK STORAGE (IN K WORDS) 

Respond with any decimal integer from 128 (K equals 1024]o) dirough 2048 
(2 million words) in increments of 128 (128K). The program then queries you 

about the file subdivisions and file names you may wish to assign to die disk 
space for die fixed head disk. These queries are made in a series of questions 

with three parts each: 
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Producing the RTQS Module (Continued) 

1ST BLOCK? 

END BLOCK? 
NAME? 

You respond with the first logical block address in each disk file; the first avail- 
able block will be unless you plan to use the disk bootstrap program, HIPBOOT, 
to load and execute RTOS programs. If disk space for HIPBOOT is to be reserved, 
the first available block address is block number 6, 

You must assign a file name to all disk space which you want to be program 
accessible. The file names you define will be the names by which the disk 
files are opened via the system . OPEN command. File names consist of 
from 4 to 6 upper- case alphabetic and numeric characters. Each file name 
must uniquely identify its associated file; the same block cannot be assigned 
more than one file name, since one disk block cannot be included within the 
file space of more than one file. Files defined during system generation 
cannot be expanded or reduced in size. For a discussion of contiguous disk 
files, see Chapter l,"Disk File Organization." 

After defining all file space, respond with a carriage return to the "1ST 
BLOCK" question. RTOSGEN will now proceed to question number 7. 

7. DKP (0-4) ? (moving head disks) 

Respond with the number of moving head disk units in your system (the 404 7B 
is considered to be two units). If there are no moving head units, respond 0; 
the system will then proceed to question 8. 

After you answer the unit number question affirmatively, the program requests 
the number of sectors per surface in each unit, and the number of disk sur- 
faces per unit ( see How to Use the Nova Computers for a discussion of disk 
terms); 

#SECTORS ? 

# SURFACES/UNIT ? 

Specify 6 sectors for the 4048 unit, or 12 sectors for either the 4047 or the 
4057 units. Specify 2 surfaces for the 4047 unit, 10 for the 4048 unit, or 20 
for the 4057 unit. 

The program then queries you about the file subdivisions and file names you 
wish to assign to the disk space for each moving head disk unit. These queries 
are made in a series of questions with three parts each: 
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Producing the RTQS Module (Continued) 

1ST BLOCK? 
END BLOCK? 
NAME? 

You respond with the first logical block address in each disk file. The first 
available block in each unit will be unless you intend to run one or more RTOS 
programs using disk file space found on an RDOS pack. In this case, file space 
which will be accessed by RTOS must be allocated by an RDOS CCONT (.CCONT) 
command. The LIST/E CLI command will then indicate the starting and ending 
block numbers comprising the contiguous files; it is these numbers which you 
would then use in responding to this RTOSGEN question series. 

You must assign a file name to all disk space which you want to be program 
accessible. The file names you define will be the names by which the disk 
files are opened via the system , OPEN command. File names consist of from 
4 to 6 upper-case alphabetic and numeric characters. Each file name must 
uniquely identify its associated file; the same block cannot be assigned more than 
one file name, since a single disk block cannot be included within the file space 
of more than one file. Files defined during system generation cannot be expanded 
or reduced in size. For a discussion of contiguous disk files, see Chapter 1, 
"Disk File Organization. " 

After defining all file space within each moving head unit, respond with a 
carriage return to the "1ST BLOCK" question. RTOSGEN will now proceed to 
question number 8. 

8. MTA (0-8) ? (magnetic tape transports) 

Respond with the appropriate integer indicating the number of 7- or 9-track 
magnetic tape transports in your system. If your response is non-zero, go 
to question 9; otherwise go to 10. 

9. BUFFERED I/O (1=YES 0=NO) ? 

Respond with the appropriate integer indicating whether line and sequential 
(buffered) I/O is to be available for magnetic tape units. A response of "1" 
makes buffered I/O available for cassettes too if any are selected in question 
10; a response of "0" makes buffered I/O unavailable to both magnetic tape 

and cassette units. 
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10. CAS (0-8) ? (cassette units) 

Respond with the appropriate integer indicating the number of cassettes in 
your system. If your response is non-zero, then step to question ii unless 
you have already responded to question 9, Any response given to question 9 
will be applied to cassettes also, 

11. BUFFERED I/O (1=YES 0=NO) ? 

Respond with the appropriate integers indicating whether line and sequential 
(buffered) I/O is to be available for cassette units. 

12. PTR (0-2) ? (high-speed paper tape readers) 

Respond with the appropriate integer indicating the number of high-speed 
paper tape readers in your system. 

13. FTP (0-2) ? (high-speed paper tape punches) 

Respond with the appropriate integer indicating the number of high-speed 
paper tape punches in your system. 



14. LPT (0-2) ? (line printers) 

Respond with the appropriate integer indicating the number of line printers 
in your system. If your response is 1 or 2, the program asks you for the 
column size(s) of your printer (s) with the query: 

COLUMN SIZE (80, 132) 

The query is repeated if you have specified 2 line printers in your system. 

15. CDR (0-2) ? (punched or mark sense card readers) 

Respond with the appropriate integer indicating the number of card readers in 
your system. 

16. PLT (0-2) ? (incremental plotters) 

Respond with the appropriate integer indicating the number of digital plotters 
in your system. 
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Producing the RTOS Module (Continued) 

17. QTY (0-64) ? (asynchronous data communications multiplexor lines) 

Respond with the appropriate Integer indicating the number of full duplex 

lines in your system, 

18. TTYS (0-3) ? (teletypewriters or video displays) 

Respond with the appropriate integer indicating the number of teletypewriters 
or video display units in your system. 

19. MCA (0-15) ? 

Respond with the appropriate integer indicating the number of MCA lines in 
your system (each line is capable of both transmitting and receiving). If your 
response is non-zero, the program asks you for the default number of trans- 
mission retries: 

#TIMEOUT RETRIES (0-65535) ? 

Each hardware timeout consumes approximately 10 milliseconds. After you 
respond to this question, the program outputs a query signaling the approach 
of the last block of RTOS GEN questions; 

RESPOND WITH FOR NO, 1 FOR YES 



20. AUTO RESTART? 

Respond "1" if the power fail/auto restart is included in your system; other- 
wise, respond to "0". 

21. HIGH PRIORITY INTERRUPTS? 

Respond "1" if you have any user-written drivers whose interrupts you want 
to be serviced before all system devices (but after the power fail monitor 
and real time clock). Respond "0" if you do not have any high priority interrupt 
devices. If you respond "1", the program will ask you for the name and device 
code of each high priority interrupt device (the name consists of 3 alpha- 
numeric characters): 

DEVICE CODE? 
NAME? 
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21. HIGH PRIORITY INTERRUPTS ? (Continued) 

'Toe system appends "IS" to the device name and inserts the name into the high 
priority interrupt table. After listing all high priority interrupt devices, 
respond with a carriage return to the DEVICE CODE query, and the program 
will then step to question 20. 

22. USER SUPPLIED DRIVERS? 

Respond "1" if you have any user -written drivers you want included in the 
RTOS module output by RTOSGEN. (This Is an alternative to introducing 
drivers at run time by the system call . IDEF . ) If you have no such drivers, 
respond "0". If you respond in the affirmative, the program requests the 
device code and name of each device (the name consists of 3 alphanumeric 
characters): 

DEVICE CODE? 
NAME? 

The system appends "DC" to the device name to create the DCT name for the 
device. After listing all user device drivers, respond with a carriage return 
to the DEVICE CODE query, and the program will then step to the next 
question. 

23. COMPUTER: NOVA (0) OR ECLIPSE (1) ? 

Respond "0" if the system will use a NOVA computer, or "1" if you will be 
using an ECLIPSE computer. Follow this response with a carriage return, 
and the program will then proceed to output the system generation summary. 

RTOS now outputs a list of all device codes, DCT names, and device names 

for all system devices and user devices specified during the system 
generation process. The power fail/auto restart option and high priority 
user interrupt devices are not included in this list, since there is no DCT 
associated with these devices. 

24. After the list has been finished, the program asks whether the system gen- 
eration procedure has been followed satisfactorily: 

SYSGEN OKAY? 
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_P rodiicing the RTGS Module (Continued) 

Z^^Zi™?^^* ° r nM th6re ™ ** ™s i- yo- 
If vou tvoe -n- thl f r ° rS ' type " 1 " : otherwise type "0". 

!Ut)Pe ° the entlre s >' stem generation dialogue will be repeated. 

If you respond "1", RTOSGEN will then ask the name of the file or clevis 
which is to be used for outputting the RTOS module: 

OUTPUT FILENAME? 

Respond with the name of the appropriate file or device. Resnond with fl 
carriage return if the default name RTOS.RB is desired. 

*™*™ wl " °«tP«t a 50-null leader (if the punch is used) followed by the 

RIOSGEN module proner Aft-Pr * G dthc j i , ^^uwcu uy tne 

B asic System : (1) NOVA system ECLIPSE system 

Options: ^o 

2632 2642 

multitasking programming (2) 1674 



each additional TCB 1S 

each additional channel 21 

power fail/auto restart (PWRDR) 165 

high priority interrupts (n = 11+3n 

number of high priority ~ 

devices excluding RTC and PWR) 
real time clock (RTCDR) 466 



165 
ll+3n 



466 



S TCBMofn™'^™' ™ GENI °' I0SER > ^one TCB 

and T Q °TAS leSS ^ ^ ° f TMIN) ' TXMT > TACA L, TSKID, TUMOD, TABOR, 
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Producing the RTOS Module (Continued) 



Peripherals: 



fixed head disk (DSKDR) 

moving head disk (DKPDR) 

each disk file: fixed head/moving head 

magnetic tape driver (MTADR) 

each magnetic tape unit (MTUn) 
cassette tape driver (CASDR) 

each cassette tape unit (CTUn) 
tape service routine (MTSER); 

shared by MTADR and CASDR 
buffered tape I/O package, i. e. , 

support for mag tape/cassette 

. RDL/. RDS/. WRL/. WRS 
teletypewriter driver (TTYDR) 

each additional console (TTY1D, 

TTY2D) 
paper tape reader (PTRDR) 

second paper tape reader (PTR1D) 
paper tape punch (PTPDR) 

second paper tape punch (PTP1D) 
card reader (CDRDR) 

second card reader (CDR1D) 
line printer (LPTDR) 

second line printer (LPT ID) 
plotter (PLTDR) 

second plotter (PLT1D) 
device name table (.CHTB) 

type 4060 multiplexer (QTYDR) 

each QTY line 
multiprocessor communications 

adapter (MCADR) 

MCA device file table (. MCTB) 



NOVA 


system 


ECLIPSE 


I system 


213 


213 




500 




500 




5/6 




5/6 




54 




54 




414 




414 




56 




56 




414 




414 




726 




726 





377 



377 



347 






347 


101 






101 


215 






215 


45 






45 


54 






54 


30 






30 


646 






646 


170 






170 


70 






70 


44 






44 


53 






53 


30 






30 


4* 


no. 


of 


4*no. of 




devices 


devices 


764 






764 


12 






12 


740 






740 


20^ 


5 (no. 


of 


20* (no. of 




line 


>s+l) 


lines +1) 
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This page illustrates a sample output listing of the RTOSGEN dialogue, 

RTOS SYSTEM GENERATION 

CORE STORAGE (IN K WORDS) 12 

RTC FREQ (0=NONE, 1=10HZ, 2=100HZ, 3=1000HZ, 4=LINE) 4 
LINE FREQ (0=50HZ, 1=60HZ) 1 

TASKS (1-255) *> 10 
CHANNELSC1-63) ? 8 

RESPOND WITH NUMBER OF UNITS 

DISK (0-1) ? 1 

DISK STORAGE (IN K WORDS) 128 

DISK FILE STRUCTURE 

1ST BLOCK? 5 

END BLOCK? 200 

NAME? FILE A 

1ST BLOCK? 201 

END BLOCK? 506 

NAME? FILEB 

1ST BLOCK? 507 

END BLOCK? 509 

NAME? FILEC 

1ST BLOCK? 510 

END BLOCK? 511 

NAME? FILED 

DKP(0-4) ? 

MTA(0-8) ? 

BUFFERED I/O (1=YES, 0=NO) 1 
CAS (0-8) ? 

PTR(0-2) ? 1 

FTP (0-2) ? 1 

LPT (0-2) ? 1 

COLUMN SIZE (80, 132) 80 
CDR(0-2) ? 
PUT (0-2) ? 
QTY(0-64)? 
TTYS(0-3)? 1 
MCA (0-15)? 2 

#TIMEOUT RETRIES (0-65535) ? 200 

RESPOND WITH FOR NO, 1 FOR YES 

AUTO RESTART ? 1 

HIGH PRIORITY INTERRUPTS? 

USER SUPPLIED DRIVERS? 

COMPUTER: NOVA (0) OR ECLIPSE (1) ? 

SUMMARY OF RTOS SYSGEN 

CODE DCT NAME 



06 


MCTDC 




07 


MCRDC 




10 


TTIDC 


$TTI 


11 


TTODC 


STTO 


12 


PTRDC 


$PTR 


13 


PTPDC 


SPTP 


14 


RTC DC 




17 


LPT DC 


$LPT 


20 


DSKDC 




SYSGEN OKAY? 1 




OUTPUT FILENAME ? 


SYS1 


R 




Sample RTOSGEN Dialogue 
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LOADING AND RUNNING A PROGRAM IN A STAND-ALONE ENVIRONMENT 

Having produced the RTOS module, you are now ready to load th_- r>j rating 
system with program relocatable binaries and execute it as ar R "OS program 
or run it under RDOS, If you wish to load and execute it in a stand-alone environ- 
ment you must first perform a stand-alone or SOS relocatable load. 

Performing a Stand-alone or SOS Relocatable Load 

For a complete description of operating procedures using the SOS and stand- 
alone extended relocatable loaders, refer to the Extended Relocatable Loaders 
Manual, 093-000080. The following summarizes stand-alone procedures 
required for loading system and user programs. 

The stand-alone relocatable loader is in absolute binary format, and thus it 
is loaded by means of the binary loader. Once loaded, the relocatable loader 
self-starts and types on the console: 

SAFE= 

You respond with a carriage return to reserve the upper 200 words of memory, 
preserving both the bootstrap and binary loaders. The relocatable loader now 
outputs the prompt: 



You now proceed to load a series of paper tapes, following tape loading pro- 
cedures which will be described. The order in which the first three categories 
of tapes is loaded is not critical; the RTOS libraries must be the last items 
loaded: 

1. The RTOS module 

2. User drivers (if any) 

3. User relocatable binaries (the user program proper) 

4. The RTOS libraries 

To load each of the above paper tapes, mount each tape in turn in either the 
teletype reader or the paper tape reader, and type either 1 or 2 indicating to 
the loader whether the teletype reader (1) or the high-speed reader (2) is to 
be used. After loading each tape, the loader outputs the star prompt (*). 
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Performing a Stand-alone or SOS Relocatable Load (Continued) 

After the last paper tape has been loaded, you may request a loader map by typing 
the number 6. "Then, to terminate the load process and prepare the program for 
execution, type the number 8. This causes the previously loaded program to be 
moved so that it resides at the absolute addresses indicated by the loader map. 
After shuffling the program downward to its indicated positions in core memory, 
the loader halts. 

If the SOS Magnetic Tape /Cassette relocatable loader (SOS loader) is to be used, 
the core image loader/writer should first be loaded into main memory; the same 

series of files must then be loaded in sequence. After the prompt 

RLDR 

is received, a command line must be input via the console. Suppose that cassette 
files are used and three cassette transports are available. Moreover, the user 
RTOS program binaries exist on file zero of one cassette, and the RTOSGEN 
module, user drivers, and RTOS libraries exist on files 0, 1, and 2 of another 
cassette. One possible command line would be as follows: 

$TTO/L CT0;1/S CT1:0 CT1:1 CT2:0 CT1:2 ), 

This command line would cause a numeric symbol table listing to be output on 
$TTO and the RTOS save file to go to file 1 of transport (CBOOT, the cassette 
bootstrap, exists on file 0). The RTOS module, user drivers user program 
binaries, and RTOS libraries are then loaded in order. Upon the successful com- 
pletion of the relocatable load, the message 'OK" is output on the console and the 
system halts with the loaded program in core memory ready to be executed. 

Executing a Stand-alone Program 

The first operation performed by any program run under RTOS is a system initial- 
ization. Since the address of the RTOS initialization routine always resides in 
location 2, control must be dispatched to the address in location 2 in order to start 
an RTOS program. RTOS has a JMP §2 instruction at location 376. Thus to 
start your program, place "376" in the data switches, press RESET, then START. 

RTOS will initialize the system and transfer control to your program if you defined 
a starting address in your program in the . END statement. If you defined no such 
starting address, you must now place your program starting address in the data 
switches and press START. Your program now runs until a HALT or JMP. instruc- 
tion is encountered, or all tasks are killed (in which case control is returned to the 
task scheduler). 
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loading and running A program in ax rdos environment 

After writing your program, you may test it as an RDOS save file, you may rim it 
on an RDOS system as a stand-alone program (disabling RDOS temporarily), or you 
may output it as an absolute program on some external medium for execution on 
another system. 

Running the program under RDOS for test purposes may save you debugging time. 
This procedure is equivalent to testing and running an RDOS save file, since the 
RTOS command set is a compatible subset of the RDOS command repertoire. If 
you wish to test your program under RDOS, consult the Extended Relocatable 
Loaders Manual , 93-000080, and the Real Time Disk Operating System User's 
Manual , 93-000075. Note that you may specify task /channel information eidier via 
RLDR local switches /C and ,/K, or in the . COMM TASK statement. 

Alternatively, you want to load your RTOS program using the RDOS loader but with 
the RTOSGEN module and RTOS libraries, and execute your program on this RDOS 
system or on another RDOS system. The following sections describe these pro- 
cedures. 

Loading an RTOS Program under RDOS 

For a complete description of operating procedures using the RDOS relocatable 
loader, refer to the Extended Relocatable Loaders Manual , 93-000080, and to the 
Real Time Disk Operating System User's Manual , 93-000075. The following 
summary hiformation gives procedures for loading a user program with the RTOS 
module under RDOS. 

The following files are required for the relocatable loading process: 

1. RTOS.RB (produced during RTOS system generation). 

2. Userdrivers, if any. 

3. User relocatable binaries (i.e., the user program proper). 

4. The RTOS libraries. 

These four files must be loaded onto disk by mounting each on the teletype reader 
or high-speed reader and by issuing the following command: 

XFER j$TT R } m^Be) 

Having loaded all the necessary tapes, you now issue the CLI relocatable load 
command: 
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Loading an RTQS Program under RDOS (Continued) 

RLDR/Cf /Dj user binaries f user drivers ^ RTOSGEK module RTOS libraries f 



(stto/l) 
j$lpt/l) 



This command will cause the complete save file to be constructed, starting at 
location zero. The load map will be output on the listing device, if one is specified 

If in the above illustration you have loaded the debugger (global /D)» you must do 
one of two things to transfer control to the debugger. Your choice depends upon 
the means selected to start the RTOS program. These means are described 
fully in the following section. If location 2 will receive control upon the execution 
of the save file, then the debugger address (found in the load map, DEBUG) must 
be placed on location 2 via the Octal Editor. Alternatively, you may get the 
debugger address from location 406 of the program's User Status Table and start 
at that address. In either case, after starting the debugger, the command 
" . RTOS$R"will transfer control to the RTOS initializer, starting the RTOS pro- 
gram. 

Executing an RTOS Program with HIPBOOT 

Having performed a relocatable load of your program with the RTOS module and 
RTOS libraries, you may now choose from many different methods to execute the 
program; your choice of method will be made largely on the basis of the type of 
system which will be used to run the program. 

If you intend to execute the program on an RDOS system, you may use the disk 
bootstrap program, HIPBOOT, to transfer control to your program. Otherwise, 
you must produce an absolute binary paper tape, or a magnetic tape/cassette 
version of the program and load it on another system by means of an appropriate 
loader. If HIPBOOT is used, the computer halts at the termination of loading. 
This provides an opportunity to activate the debugger via the front panel 
switches, if desired. 



If your program is to be executed on the present RDOS system or on another RDOS 
system you may invoke the disk bootstrap program, HIPBOOT, to execute your 
program. If the RTOS program is on a removable pack or cartridge you may 
simply transfer the pack or cartridge to the new system; otherwise you must dump 
the RTOS save file and reload it on the new system: 
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Executing an RTOS Program with HIPBOOT (Continued) 

DUMP oiitputdevicename program- name. SV ) 

LOAD inputdevicename program- name. SV ) 

Having obtained a copy of the RTOS program on the RDOS system where it is to be 
run, you now invoke HIPBOOT, following ordinary disk bootstrap procedures. 
These procedures are described fully in the RDOS Reference Manual , Appendices 
A and E; a summary of these procedures follows. 

Disk bootstrap procedures vary with the type of computer used and the presence 
or absence of the program load feature. The following three procedures are given. 

1. NOVA®* 2/NOVA 1200/NOVA 800 series and ECLIPSE™** without 
the Program Load Option: 

a. Enter in location 376: 60 Inn 

where nn=20 when bootstrapping from the fixed head disk and 
nn=30 when bootstrapping from the moving head disk. 

b. Enter in location 377: 377. 

c. Press RESET, then start at location 376; go to step 3c. 

2. NOVA 2/NOVA 1200/NOVA 800 series and ECLIPSE series with the 
Program Load Option: 

a. Set bit of the data switches up. 

b. Enter the proper disk device code (20 or 33 as described in 
la.) into the data switches, bits 10-15. 

c. Press RESET, then PROGRAM LOAD; go to step 3c. 

3. SUPERNOVA®*; 

a. Enter the proper disk device code (20 or 33 as described in la). 

b. Press RESET, then CHANNEL START. 

c. HIPBOOT now requests the name of your program. 

FILENAME? 



*NOVA and SUPERNOVA are registered trademarks of Data General Corporation, 

Southboro, Massachusetts. 

** ECLIPSE is a trademark of Data General Corporation, Southboro, Massachusetts. 
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Executing an RTOS Program with HIPBQQT (Continued) 

You must now respond with the name of your program in one of two ways: 

1. name / A ) 

2. name *) 

If you select the first method, your program will be loaded into memory and the 
computer will halt. You then place a starting address (your program's or the 
debugger's) into the address switches, press RESET, and then START. If you 
select the second response, the program will self -start. 

Having been loaded, if the RTOS program self-starts it will initialize the system 
and transfer control to your program if you defined a starting address via your 
program's . END statement. If the program does not self -start, you may start at 
either the contents of location 2 or, to activate the debugger, at the contents of 
location 406. 

Since this procedure overwrites portions of RDOS, RTOS gains control; RDOS can 
only be restored via disk bootstrap procedures similar to those given on the pre- 
vious page. 

Executing an RTOS Program with TBOOT, CBOOT or MCABOOT 

If you wish to execute your program on a system which has a magnetic tape 
transport or cassette unit, you must first transfer the magnetic tape bootstrap 
(TBOOT) or cassette bootstrap (CBOOT) to file of the tape on unit 0. 



INIT 



/TBOOT. SV 
XFER } > < I ) 

( CBOOT. SV* ICTOiO; 

After transferring the appropriate tape bootstrap to file 0, transfer the RTOS 
program to file 1 of the same tape: 

(MT0:1) 
XFER program name. SV < > ) 

ICTO.tJ 
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Executing an RTOS Program with TBOOT, GBOOT or MCABOOT (Continued) 

If several RTOS programs are to be stored on the tape reel, they can be trans- 
ferred to sequential file numbers following file 1. 

Having produced the tape reel, release the reel via the RDOS command 

RELEASE j CT0 |J 

Dismount the reel, and mount it on the unit zero transport or cassette unit of the 
system where the RTOS program(s) is to be executed. 

After mounting the reel, perform one of the following operation sequences: 

1. On machines having the Program Load feature (NOVA 2/800/1200 
and ECLIPSE families), set the console switches to 100022 for a 
magnetic tape transport, or 100034 for a cassette unit, and press 
PROGRAM LOAD. 

2. On SUPERNOVA computers with the Channel Start option, set the 
console switches to octal 22 (for a magnetic tape unit) or octal 

34 (for a cassette unit), and press RESET, then CHANNEL START. 

3. On machines without Channel Start or Program Load options, 
deposit NIOS MTA (60122) or NIOS CTA (60134) in location 376, 
deposit 377 in location 377, press RESET, and START at 
location 376. 

The appropriate tape bootstrap program will be loaded into memory, and the 
following initialization message will be output on the console: 

FULL (0) OR PARTIAL (1) ? 

Type "1" in response to this query, and the tape bootstrap will then request the 
number of the file containing the program which is to be executed: 

FROM | MT0: 
(CT0: 
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Executing an RTOS Program w ith TBOQT, CBOOT or MCABOOT (Continued) 

Respond with the number of the file containing the program, and follow this with 
a carriage return. The tape file will be read, and control will be given to your 
program. 

To transmit an RTOS program from one CPU to another via the multiprocessor 
communications adapter, two actions must be performed: one at me transmitting 
RDOS CPU, and another at a receiving CPU. At the transmitting CPU, the fol- 
lowing CLI command must be issued. 

MCABOOT MCATm RTOS program name /S 

where n is a number from 1 to 15 decimal denoting the receiving MCA unit 
number. At the receiving CPU, an operator must have requested the sender's 
transmission by first placing "100007" in the receiver's data switches, then by 
depressing RESET, followed by PROGRAM LOAD . The transmitting unit 
will wait for the receiver to request the transmission, up to the default timeout 
period. After the RTOS program has been received, the receiving operator must 
place the value "376" in the data switches, and then press RESET followed by 

o 1 Art 1 , 

EXECUTING AN RTOS PROGRAM VIA PAPER TAPE WHIC H WAS PRODUCED UNDER 
RDOS " — ~ ^ 

If you have loaded your RTOS program via the RDOS relocatable loader, but now 
wish to run this program in a stand-alone environment, you may output this program 
onto paper tape. If you do not wish to preserve a disk file containing this RTOS 
program, simply issue the command : 

($TTP) 
MKABS/Z program name . SV f 376/S^ < >) 

($ptp; 

Alternatively, if you wish to preserve a disk copy of this program before outputting 
it onto paper tape, Issue the commands: 

MKABS/Z program name .SV program name . AB { 376/S] ) 
XFER program name .AB $PTP ) 

Hie paper tape version of your program can now be loaded onto a non-RDOS 
system following conventional binary load procedures. After loading the paper 
tape, if you supplied the intializer entry with the /S switch, control will be 
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transferred to the RTOS initializer; if you did not specify an initializer entry 
address, you must place the value "376" into the data switches, press RESET, 
then START, 

In either case, after RTOS performs its initialization it will transfer control to 
the starting address of your program if you specified a starting address as an 
argument in the main program's . END statement. If you specified no such 
starting address, the machine will stop after initialization and you must place 
your program's starting address in the data switches, press RESET, then START, 
Your program will now run until a HALT or IMP . instruction is encountered. 

EXECUTING AN RTOS PROGRAM WITH THE SOS CORE IMAGE LOADER/WRITER 

If the SOS core image loader/writer is to be used to execute an RTOS program, 
one of two relocatable loaders must have been used and one of two corresponding 
means must have been used to place the RTOS program onto cassette or magnetic 
tape: 

1. SOS relocatable loader (the core image loader/writer must have 
been resident in main memory before the relocatable load). 

2. RDOS relocatable loader. 

If the first method is selected, the core resident RTOS program must be written 
onto either a reel of magnetic tape or a cassette cartridge onto which the loader/ 
writer has been written as file zero. Core image loader/writer operation is 
discussed in detail in die SOS User's Manual , 093-000062. In summary, to 
transfer the SOS relocatably loaded program to tape, start die computer at die 
next to last address in main memory. This will activate die loader/writer, which 
outputs a prompt, "#". After outputting die prompt, die loader/writer waits for 
you to input a device number and file number, separated by a colon, to which the 
core resident program is to be written. After the file has been specified, the 
core image writer will request specification of the upper core address (NMAX) 
to be written onto tape. It does this by typing 

NMAX: 

on die console. You must tiien respond with die highest core address (in octal) 
winch is v. !v writtjr nut. 
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EXECUTING AN RTOS PROGRAM WITH THE SOS CORE IMAGE LOADER/WRITER 

(Continued) 

Having written the RTOS program onto tape, it then may be read in from tape and 
be executed by means of the core image loader. Set the console data switch up, 
and activate the core image loader by starting the computer at the highest available 
memory- address, 'The loader issues the " ri " prompt on the console, and then awaits 
your response of a device number (0-7),colon, and a file number (0-99) followed by 
a carriage return. Hie indicated tape file is then loaded into memory' starting at 
address zero. The loader will halt after loading is complete. 

If instead of the SOS loader the RDOS relocatable loader is used to create the RTOS 
program, this save file can be XFERed by the CLI to a file on cassette or magnetic 
tape. This file can then be executed by means of the core image loader as des- 
cribed above. 

The illustration on the following page summarizes the various methods which may 
be used to execute an RTOS program. The illustration starts with the relocatable 
binary modules comprising the program; these binaries are produced either by an 
RDOS assembler or by the SOS assembler. 
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Stand -alone 

Extended 

Relocatable 
^ Loader 




SOS 
Relocatable 
Loader 



•RLDR/C" 



*KLDR, , , " 



Core -resident 
RTOS program 



Core -resident 
RTOS program 
(SOS loader/writei 
):--...„::. 




program. SV 
disk file 
(following RTOS 
conventions) 



Write to tape 

with SOS 
loader /writer 




"XFER" 
TBOOT (CBOOT) 
or SOS loader/ 
writer, and 
program. SV 




program . SV 
disk file 



program ' 



"MKABS/S 

to 

program. AB 



MKABS" 

to 

$PTP 




"BOOT" 
(HIPBOOT) 

or 
"MCABOOT' 



program . AB 



disk file 



magnetic tape 
or 
cassette file 



\ 




SOS 

loader/writer 

TBOOT 

(CBOOT) 

partial 

initialization 




absolute binary 
paper tape 
program 



binary 
loader 



RTOS Execution Procedures 
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APPENDIX C 

RTOS PARAMETERS 

Supplied with RTOS is a set of parameters, PARR, which must be assembled with 
programs using RTOS and using system- defined mnemonics. A listing of these 
parameters begins on page C-2. 
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0001 

01 

02 

03 

04 

05 

06 

07 

88 

89 

10 

1 ! 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

3a 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 



LICENSED MATERIAL - PROPERTY 0^ DATA GENERAL CORPORATION 
.MAIN MACRO REV 03,00 l«:16:e6 02/05/75 



I ***************** 


•♦A**********************************.*. 


1 RRRRR 


TTTTTTT 


0000 


SS8S ; 


R R 




T 





s s 


I R R 




T 





S | 


I RRRRR 




T 





SSSS ; 


1 R R 




T 





S ? 


1 R R 




T 





S S ; 


R R 




T 


0000 


SSSS ; 


; THE OPERATING 


SYSTEM 


YOU CAN UNDERSTAND ; 


; ***************** 


********************** 


***************** 



I RTOS - - REAL TIME OPERATING SYSTEM 

i - - FOR THE DATA GENERAL FAMILY OF COMPUTERS 

• **** RTOS PARAMETER TAPE **** 

I FORTRAN 4 CONDITIONAL ASSEMBLY SWITCH 

000000 FaSW=0 ; SUPERSEDED BY FORTRAN IV PARAMETERS IF PRESENT 

I DEFINE THE USER STACK DISPLACEMENTS 



000800 .DUSR SSAC2 = 

177777 .DUSR SSAC1 = SSAC2-1 

177776 .DUSR SSAC0 = SSACl-1 

177775 .DUSR SSCRY - SSAC0-1 

177774 .DUSR SSEAD = SSCRY-1 

177773 .DUSR SSRTN = SSEAD-1 

mm .dusr ssosp = ssrtn-i 

177771 .DUSR SSLGT = SS0SP-1 



»• (DON'T MODIFY THIS DISPLACEMENT) 

; SAVE FOR CALLERS* ACCUMULATORS 

; 

; CARRY 

? ENTRY ADDRESS OF CALLED PROGRAM 

I RETURN ADDRESS TO CALLING PROGRAM 

I PREVIOUS STACK POINTER 

', VARIABLE LENGTH OF CALLING PROGRAMS' FRAME 



,* DEVICE CHARACTERISTICS 





; .DUSR 


• • • 


1 B 1 5 


000001 


.DUSR 


DCCPO= 


1 B 1 5 ; 


000002 


.DUSR 


DCCGNr 


1814 


000004 


.DUSR 


DCIDIs 


1 B 1 3 


000010 


.DUSR 


DCCNF= 


1 B 1 2 ; 


000020 


.DUSR 


DCTO = 


1 B 1 1 


000040 


.DUSR 


DCKEY= 


1 B 1 ; 


000100 


.DUSR 


DCNAF= 


1B09 ; 


000200 


• DUSR 


DCRAT= 


1B08 1 


000400 


.DUSR 


DCPCK= 


1B07 


001000 


.DUSR 


DCLAC= 


IB 06 ; 


002000 


.DUSR 


DCPFR= 


1B05 


004000 


.DUSR 


DCFhDs 


1B0« ; 


010000 


.DUSR 


DCFFO= 


1803 


020000 


.DUSR 


DCLTU= 


IB 02 


040000 


.DUSR 


DCC80= 


1B01 




; .DUSR 


... 


1B0 ; 



IF SUPPRESSED ON OPEN: 
USER SPECIFIED TIMEOUT (MCA). 
REQUIRES LEADER/TRAILER 
REQUIRES TAB SIMULATION 
BUF'D INPUT DEV. (RDOS: OP. INTERV.) 
OUTPUT DEV. WITHOUT FORM FEED HARDWARE 
TELETYPE OUTPUT DEVICE 
KEYBOARD DEVICE 

REQUIRES NULLS AFTER FORM FEEDS 
REQUIRES RUBOUTS AFTER TABS 
REQUIRES PARITY CHECK 
REQUIRES LINE FEEDS AFTER C.R.'S 
INTERNAL TO RTOS; AUTORESTART MODE BIT 
INTERRUPT PER FULL WORD I/O DEVICE 
REQUIRES FORM FEED ON OPEN 
CHANGE LOftER CASE ASCII TO UPPER 
WRITE 80 COLUMNS 
DEVICE KITH BEAD QUEUE 
(INTERNAL TO RTOS, NON-PARAMETRIC) 

/ 
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LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 


I0i02 

ei 


.MAIN 








03 
05 




1 USER STATUS TABLE CUST) TEMPLATE 


000438 


.PUSR 


UST = 


«00 1 START OF USER STATUS AREA 


06 


000000 


,0U5R 


USTPC= 


; RESERVED FOR RODS COMPATIBILITY 


7 


800001 


,OUSR 


USTZ^= 


1 ; Zf«'AX 


08 


000002 


»OUSR 


USTSS= 


2 ; START OF SYMBOL TABLE 


09 


030003 


,OUS» 


USTES= 


3 ; END OF SYMBOL TABLE 


10 


000004 


,OUSR 


USTNMs 


U ; NMAX 


11 


000005 


.OUSR 


USTSAs 


5 I STARTING ADDRESS 


12 


000086 


„DUSR 


USTOA= 


6 ; DEBUGGER ADDRESS 


13 


000007 


.OUSR 


USTHU= 


7 ; HIGHEST ADDRESS USED 


m 


000018 


,DUSR 


USTCS= 


10 ', FORTRAN COMMON AREA SIZE 


15 


800011 


.OUSR 


USTIT= 


11 ; INTERRUPT ADDRESS (NOT USED) 


16 


000012 


.OUSR 


USTBR= 


12 ; BREAK ADDRESS (NOT USED) 


17 


033013 


.OUSR 


USTCHs 


13 ; n TASKS (LEFT), U ZHkHS (RIGHT) 


18 


00801 a 


.OUSR 


USTCT= 


14 } INITIAL TCB ADDRESS 


19 


080015 


.PUSR 


USTACs 


15 ', START OF READY TCB QUEUE 


20 


000016 


.OUSR 


USTFC= 


16 ; START OF FREE TCB CHAIN 


21 


000017 


.OUSR 


USTIN= 


17 ; INITIAL START OF NREL CODE 


22 


000020 


.OUSR 


USTOO= 


20 ; RESERVED FOR RDOS COMPATIBILITY 


23 


000321 


.OUSR 


USTSVs 


21 J FORTRAN STATfc SAVE ROUTINE (OR 0) 


2« 




I 




--RDOS UST ENDS HERE-- 


25 


000022 


.OUSR 


USTSQ= 


22 ; START OF SUSPEND QUEUE 


26 


000823 


.OUSR 


USTXQs 


23 } START OF .XMT/.REC QUEUE 


27 


08002a 


.'OUSR 


USTPQ= 


2a ; START OF PSEUDO TASK QUEUE 


28 


000825 


.OUSR 


USTOS= 


25 ', 1-SECOND CLOCK, SCHEDULER IDLE COUNTER 


29 


000026 


.OUSR 


USTNA= 


26 ? NUMBER OF ACTIVE (LIVE) TASKS 


30 
31 


000026 


.OUSR 


USTENs 


26 ', LAST ENTRY 


32 
33 

3a 
35 




; LAYOUT OF AN 


RTOS TASK CONTROL BLOCK (TCB) 


000000 


.OUSR 


TPC = 


; USER PC + CARRY 


36 


000001 


.OUSR 


TAC0=1 


J AC0 


37 


000002 


.OUSR 


TAC1=2 


', AC1 


38 


000003 


.OUSR 


TAC2=3 


1 AC2 


39 


00000a 


.OUSR 


TAC3=a 


; AC3 


4 


000005 


.OUSR 


TPRST=5 


I STATUS BITS t PRIORITY 


41 


000006 


.OUSR 


TSYS=6 


J SYSTEM CALL WORD 


42 


000007 


.OUSR 


TLNK=7 


; LINK WORD 


43 


000010 


.OUSR 


TUSPs 10 


; usp 


uu 


000011 


.OUSR 


TELNsll 


1 TCB EXTENSION ADDR(USED BY FORTRAN, SCHEDULERS) 


a5 


000012 


.OUSR 


TID=12 


', TASK ID Ef^TRY 


46 


000013 


.OUSR 


TTMPsi3 


,* RDOS REV 3'S CONTRIBUTION 


m 


000014 


.OUSR 


TKLAD=1« 


; KILAD ROUTINE ADDRESS 


as 


000015 


.OUSR 


TSP=15 


; STACK POINTER 


49 


000016 


.OUSR 


TFP=16 


; FRAME POINTER 


50 


000017 


.OUSR 


TSL=17 


; STACK LIMIT 


51 


000020 


• OUSR 


TSO=20 


; OVERFLOW ADDR 


52 




; DEFINE NON-BIRD TCB LENGTH 


53 


000015 


.OUSR 


TLN=TKLAC 


-TPC+1 


5a 




J DEFINE BIRD TCB LENGTH 


55 


000021 


.OUSR 


TLNB=TSO- 


TPC + 1 
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I00k3 3 
01 

02 
03 

0*i 

05 

06 

07 

08 

09 

18 

II 

12 

13 

I« 

15 

16 

1? 

18 

19 

20 
21 
22 
23 
2a 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3fl 
35 
36 
37 
38 
39 
«0 
til 

a3 
as 



> MATERIAL - PROPERTY Of DATA GENERAL CORPORATION 
I INTERRUPTED MACHINE STAT US STORAGE BLOCK LAYOUT 



; PROGRAM COUNTER AND CARRY 
; ACCUMULATOR STORAGE 



U00000 .DUSR IPCC= 

000001 .OUSR I AC 0s J 

030002 .DUSR I AC is 2 

300-383 ,DUSR 1AC2= 3 

30*3004 .DUSR I AC 3= a 

303005 .DUSR ICMSKs 5 ; CURRENT HARDWARE MASK 

•3000 .OUSR IRLOCr 6 ; RLOC 

0307 .OuSR ISvLMs IRLOC+1 I SAVE AREA LENGTH 

I FIXED LOCATION PAGE ZERO STORAGE (LOCATIONS 0-17) 





; 


• . . 







', 


... 


1 


030802 


.OUSR 


BEGINS 


2 


000003 


.OUSR 


CTCBs 


3 


000004 


.OUSR 


SCHEDs 


U 


000005 


.DUSR 


.SYS.s 


5 


000006 


.OUSR 


PLOCs 


6 


008007 


.DUSR 


IOEND= 


7 


000018 


• OUSR 


.CMSKs 


10 


00001 1 


.OUSR 


DISMISS 


= 11 


008012 


.DUSR 


USTPs 


12 


000012 


.DUSR 


PAMCs 


USTP 


000013 


.OUSR 


TLINKs 


13 


00001 a 


.DUSR 


RSCHD= 


1« 


000015 


.DUSR 


,TSAVE= 


15 




I .DUSP 


USPs 


16 




; 


• • • 


17 




; 8 IRC 


SPECIFIC 


LOCA 


0000a0 


.DUSR 


SPs 


«0 


0000«1 


.DUSR 


CSPs 


ai 


000042 


.DUSR 


CSLs 


uz 


0000«3 


• DUSR 


CSOs 


Ul> 


0000a« 


.DUSR 


XOPAs 


uu 


0000^5 


.DUSR 


FPFAs 


as 



; SYSTEM CONSTANTS 
00020a .DUSR SCLLGs 132. 



; interrupt pc storage 
i interrupt service routine address 
i overall starting address (fixed at 2) 
i current tcb address--ini ti all y has 
;; starting addr for tboot use (fixed 
;; at 3). 

I ENTRY POINT TO SCHEDULER 

I SYSTEM MODE INDICATOR 

•, ', (INITIALLY FOR HIPBOOT) 

I PAGE ZERO TEMP (=6 FOR COMPATIBILITY) 

; ENTRY POINT TO I/O END PROCESSOR 

I CURRENT SYSTEM INTERRUPT MASK 

; INTERRUPT DISMISSAL ROUTINE ADDRESS 

; DEFINED FOR COMPATIBILITY, SET TO a00 

; SYSTEM PANIC (CONTAINS JMP .} 

I ENTRY POINT TO ENQUEUE READY TCB 

,* ENTRY POINT TO READY (CTCB), SCHEDULE 

; ADDRESS OF TCB STATE SAVE ROUTINE 

-, USER STACK POINTER 

? ENTRY POINT TO SERVICE SYSTEM REQUEST 



," STACK POINTER 

; FRAME POINTER (LOGICAL STACK POINTER) 

', STACK LIMIT 

; STACK OVERFLOW ROUTINE POINTER 

,* XOP ORIGIN ADDRESS 

; FLOATING POINT FAULT ADDRESS 



; MAX LINE LENGTH FOR LINE MODE 
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1000a 

01 

02 
03 
Bti 
05 
06 
07 
88 
09 
10 
II 
12 
13 
in 

15 
16 
17 
18 
I s ? 
20 
21 
22 
23 
2« 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3ti 
35 
36 
37 
38 
39 
U0 
Ul 

a 2 

ti3 

aii 

U5 

at 



LICENSED V«'=-:;u - PROPERTY OF 1 ' T ~ '.-=-i-*. : - - j--_ - —' 
.MAIN 

I DEVICE CONTROL TABLE (OCT) TEMPLATE 



000088 .DUSR OCTSV= 

008001 .DUSR DCTM5= 1 

800082 .DUSR DCTIS= 2 

000083 .DUSR DCTCH= 3 

00i80« .DUSR OCTCOs U 

080805 ,OUSR OCTEXr 5 

000086 .DUSR DCTOT= 6 



INT STATE SAVE AOOR 
,«ASK OF LOWER PRIORITY DEVICES 
INTERRUPT SERVICE ADDR 
DEVICE CHARACTERISTICS 



WHERE Tl 
COMMAND 



I DEFINE THE COMMAND OFFSETS 



008008 
000001 
080002 
000083 
00000a 
000005 
000886 
000007 

000010 

000807 
008810 
000011 
000012 
000013 



.DUSR 

.DUSR 
.DUSR 

.DUSR 
.DUSR 
.DUSR 
.DUSR 
.DUSR 
.DUSR 

,DUSR DCTST= 
,DUSR DCT1N= 
,DUSR DCTLK= 
,DUSR DCTTO= 
,DUSR DCTD2= 



OF = 
CF = 
RS = 
RL = 
WS = 
Wl = 
R6 = 
WB = 
OA = 

7 

10 
11 
12 
13 



EXEC 


UTE I/O INSTRUCTIO 


DlSPft 


TCH TABLE ADDRESS 


TS 




OPEN 


A FILE 


CLOSE 


A FILE 


READ 


SEQUENTIAL 


READ 


LINE 


WRITE 


SEQUENTIAL 


WRITE 


LINE 


READ 


BLOCK 


WRITE 


BLOCK 


OPEN 


FILE FOR APPENDING 



8 
1 
2 
3 
a 
5 
6 
7 
10 



', DEVICE START ROUTINE 

I DEVICE INITIALIZATION ROUTINE 

J FORWARD TCB LINKAGE 

; TIMEOUT CONSTANT OR ZERO 

I DISPLACEMENT TO 2ND PART OF DCT 



', THE REMAINING DEFINITIONS ARE FOR BEAD DEVICES ONLY. 



000013 .DUSR DCTQL= 

00001a .DUSR DCTDP= 

000015 .DUSR DCTDC= 

000016 .DUSR DCTQS= 



000017 
000020 
000021 

000022 
000023 
00002a 
00002a 
000025 
000025 

000026 

000027 



.DUSR 
.DUSR 
.DUSR 
>DUSR 
.DUSR 
DUSR 
.DUSR 
.DUSR 
,DUSR 



DCTBD= 
DCTQP= 
DCTOC= 
DCTT1= 
DCTT2= 
DCTCT= 
DCTCC= 
DCTPRs 
DCTLC= 



,DUSR DCTSC= 
( DUSR DCTGN= 



13 

ia 

15 
16 

17 

20 
21 
22 

23 

2a 
2a 
25 
25 

26 
27 



? LINK IN DEVICE REQUEST BEAD CHAIN 

} DEVICE BYTE DATA POINTER 

,* DEVICE DATA COUNT 

; BEAD STATUS WORD 

; BEAD ADDRESS (.-«) 

J REQUEST BEAD QUEUE STARTING ADDR 

? OPENED DEVICE CHARACTERISTICS 

; TEMP 1 FOR DEVICE CONTROL 

; TEMP 2 FOR DEVICE CONTROL 

? CURRENT TIMEOUT COUNT CI^PUT DEVICE) 

I COLUMN COUNTER (OUTPUT DEVICE) 

; ECHO DEVICE PAIR POINTER CTTI ONLY) 

; LINE COUNTER (OUTPUT DEVICE) 

I -FOR SPECIAL OUTPUT MODE; 

,* SAVED DEVICE REQUEST BYTE COUNTER 

', CHARACTER FOR GENERATION 



C-5 



10005 

01 

02 

03 

04 

05 

06 

07 

08 

09 

10 

il 

12 

13 

i« 

15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 



LICENSED MATERIAL - PROPERTY OF DATA GE'-E-A. CC-PORATION 
i M A I N 



I BEAD COMPONENTS 

000008 ,DUSR RQLK= 

808001 .DUSR RQPTR= 1 

000002 .DUSR RGCNT= 2 

080003 .DUSR RQST = 3 



I REQUEST LINK 

I REQUEST BYTE POINTER 

; REQUEST BYTE COUNT 

I REQUEST STATUS (MODE) 



f STATUS/MODE BITS ARE DEFINED AS FOLLOWS' 



I 1B0 

; i8i 
; ib is 
; 
; 



ASSOCIATED k*ITH TCB iOCTLK 
*T CALCULATE BYTES TRANSMITTED 



BEAD IN DCT (MAIN BEAD 

PRESERVE TASK'S ACl, D 

MEANING DEPENDS ON BIT 

MAIN BEAD; LINE MODE 

OTHER BEADS REQUEST DONE (CLEARED IN ENQUE ROUTINE) 



', OFFSETS FOR USER TASK QUEUE TABLE 



000000 


• DUSR 


QPC = 





000081 


• DUSR 


QNUMr 


1 


000002 


.DUSR 


QTOV = 


2 


000803 


.DUSR 


QSH = 


3 


000004 


.DUSR 


QSMS = 


4 


000005 


.DUSR 


OPRI = 


TPRST 


000006 


.DUSR 


QRR = 


6 


000007 


.DUSR 


QTLNK= 


TLNK 


000010 


.DUSR 


QOCHs 


10 


000011 


.DUSR 


QCOND= 


11 


000012 


.DUSR 


QLDST= 


12 



000013 .DUSR QTLNr 



I STARTING PC 

? NUMBER OF TIMES TO EXECUTE 
I OVERLAY NUMBER (RDOS) 
I STARTING HOUR 
I STARTING SEC IN HOUR 
,* MUST BE SAME 
,* RERUN TIME IN SECONDS 
,* MUST BE SAME 
,* CHAN OVERLAYS OPEN ON 
? TYPE OF LOAD 
I LOAD STATUS (RDOS ONLY) 
I 1B0=LOADING, 1B15=DEQUE REQ REC 
QLDST-QPC+1 



(RDOS) 
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LICENSED MATERIAL - PROPERTY Of DATA GENERAL CORPORATI 


10086 


.MAIN 










01 




1 DEFINE THE DEVICE MASK BITS 




02 




1 


RODS REV 3 VERSION 




03 












0i| 


088083 


,OUSR 


MKTTO= 


lBia+iBl5 


', TTO 


05 


808003 


.DUSR 


WKTTI= 


MKTTO 


■ T T I 


06 


0000-83 


.DUSR 


MKQTYs 


MK T T 1 


* OT Y 


07 


030807 


.DUSR 


MKPTPs 


1B13+MKTTI 


• PTP 


08 


808017 


,DUS« 


MKMCAs 


1BI2+MKPTP 


MCA 


e9 


000017 


.OUSR 


MKPLT= 


MKMCA 


PIT 


10 


080010 


.OUSR 


MKLPTs 


10 


LPT (SPECIAL 


11 


0i0217 


.OUSR 


MKDPO= 


1B08+MKMCA , 


DPC 


12 


080217 


.DUSR 


MKOPIs 


MKOPO i 


DPI 


13 


000617 


,DUSR 


MKDKP= 


lB87tNKDPO 


MHO 


lfl 


000717 


.DUSR 


HKOSK= 


1B09+MKDKP , 


FHO 


15 


801717 


.OUSR 


MKIPB= 


1B06+MKDSK , 


1PB 


16 


001737 


• OUSR 


MKPTR= 


1B11+MKIPB , 


PTR 


17 


001777 


.DUSR 


MKCDR= 


1B10+MKPTR , 


CDR 


18 


081777 


.DUSR 


MKMTA= 


MKCDR , 


MTA 


19 


001777 


.DUSR 


MKCASs 


MKMTA , 


CAS 



CASE) 
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10007 

01 

02 

3 

g« 

05 

06 

07 

08 

09 

10 

ii 

12 

13 

t« 

15 

16 

17 

18 

19 
20 
21 
22 
23 
2« 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3« 
35 
36 



LICENSED MATERIAL - PROPERTY OF DATA GE.NEPAL CORPORATION 
.MAIN 



; DEFINE THE EXCEPTIONAL STATUS CODES 



000800 
000801 
880802 
000083 
080006 
000012 
0-30015 
080020 
000021 
800022 
000023 
200024 
000026 
000027 
008030 
008031 
000036 
0000a 1 
000042 
000043 
000045 
000047 
000050 
000060 
000061 

000101 

000103 

00010a 

000106 

0001 10 

000113 
0001 15 



,DUSR 
,DUSR 
.OUSR 

OUSR 
DUSR 
OUSR 
OUSR 
OUSR 



,DUSR 
.DUSR 
.OUSR 
.DUSR 
.OUSR 
.DUSR 
■ D'USR 
,DUSR 
,OUSR 
.DUSR 
,DUSR 
,OUSR 
,DUSR 
,DUSR 
,DUSR 
,OUSR 
,OUSR 
,OUSR 
,DUSR 
,OUSR 
,OUSR 



EPFNO= 
ERFNMs 
ERIC Ms 
ERICOs 

EREOF= 
ERDLE= 
ERFOP= 
ERNUL= 
ERUFT= 
ERLUI= 
ERRTN= 
ERPARs 
ERMEMr 
ERSPC= 
ERFIL= 
ERSEL= 
ERDNMr 
ERTIMr 
ERNOTs 
ERXMT= 
ERIBS= 
ERSIMr 
ERQTSs 
ERFIU= 
ERTID= 
ERDT0= 
ERMCAs 
ERSRR= 
ERCLO= 
ERABT= 
ERNMCs 
£RXMZ= 





1 

2 

3 

6 

12 

15 

20 

2! 

22 

23 

2« 

26 

27 

30 

31 

36 

ttl 

42 

«3 

45 

47 

50 

60 

61 

101 

103 

104 

106 

110 

113 

115 



I ILLEGAL CHANNEL NUMBER 

; ILLEGAL FILE NAME 

; ILLEGAL SYSTEM COMMAND 

I ILLEGAL COMMAND FOR DEVICE 

• £fyf) OF FILE 

; A NON-EXISTENT FILE 

; FILE NOT OPENED 

I NULL ERROR 

J ATTEMPT TO USE A UFT ALREADY IN USE 

LINE LIMIT EXCEEDED 

.RTN/.ERTN WITH NOhHERE TO GO 

PARITY ERROR ON READ LINE 

NOT ENUF MEMORY AVAILABLE 

OUT OF FILE SPACE 

FILE READ ERROR 

UNIT NOT PROPERLY SELECTED 

ILLEGAL DEVICE NAME 

USER SET TIME ERROR 

OUT OF TCB'S 

SIGNAL ADDRESS ALREADY BUSY 

DEVICE ALREADY IN SYSTEM 

QTY ERROR 

ERROR IN USER TASK QUEUE TABLE 

FILE IN USE 

TASK ID ERROR 

DEVICE TIMEOUT 

MCA ERROR 

SHORTER RECEIVE REQUEST 

I/O TERMINATED BY CLOSE 

TASK NOT ABORTABLE 

NO MCA RECEIVE REQUEST 

.XMT OR .IXMT TRANSMITTING ZERO MESSAGE 
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10008 
01 
02 
03 

§a 

85 
06 
07 
06 
09 
10 
II 
12 
13 
la 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3a 
35 
36 
37 
38 
39 
4 

ai 

42 

43 
44 
U5 
46 
47 
48 
49 
50 
51 



LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 
.MAIN 

; PARAMETERS FOR RTOS MAGTAPE MODULES 



000401 MT6Z= 257. 
008377 SCWPB= 255. 



I BUFFER SIZE, WORDS 

I USABLE WORDS PER BUFFER 



I OCT DISPLACEMENTS 



800013 


UNtjM = 


DCTOL J 


000914 


ADUCTs 


OCTDP I 


000015 


DAOR = 


OCT DC i 


000016 


OCNT = 


DCTQS ; 


000017 


lOFRPs 


OCTBD 


008020 


CMOWDs 


DC TOP ; 


000021 


TEMPr 


OCTOC ; 


000024 


OPRETs 


OCTCC 


000825 


,UCTX= 


DCTPR ; 


008826 


,ST = 


OCTSC ', 


000027 


,ISSU= 


OCTGN | 


800830 


PFR = 


. ISSU+1 I 


000031 


RTCTR= 


PFR+1 1 


000032 


MOOE = 


R T C T R 1 1 ,* 


000033 


M TOCL= 


MODE+1 ', 



UNIT NUMBER 

UNIT CONTROL TABLE ADDRESS 

DATA AREA BASE ADDRESS 

"WORD OR RECORD COUNT 

I/O FUNCTION ROUTINE INDIRECT POINTER 

= 1B0 + ACBRAMCH TABLE ENTRY) 
COMMAND WORD, READY FOR DOA 
TEMPORARY 

I/O OPERATION SUBR, RETURN ADDRESS 
A(UCTX) -> UCT INDEX 
A(STATU) -> GET STATUS SUBROUTINE 
A(ISSUE) -> ISSUE COMMANDS SUBROUTINE 
BIT 0: POSITIOMNG-FOR-RETRY MODE FLAG 

B1-B15: ERASE-FOR-WRITE-RETRY COUNTER 
RETRY COUNTER 
1=LINE, 0=SEOUENTIAL 
LENGTH OF MAG TAPE DCT 



; UCT DISPLACEMENTS 



000000 UCTPO= 
800001 UCTST= 1 
000002 UCTUNs 2 



000083 


UCT8F= 


3 


B80004 


UCTBS= 


4 


000005 


UCTBI= 


5 


000006 


UCTBO= 


6 


000007 


UCTBRs 


7 


000010 


UCTBWs 


10 


000011 


UCTUP= 


11 


000012 


UCTUC= 


12 




', STATUS VALUES 




J 


0: 




i 


-2: 




', 


-l: 




; 


+ l: 



POSITION COUNTER (CURRENT FILE #) 

STATUS BIT LOGIC WORD 

UNIT NUMBER OF THIS UCT 

SHORT UCT ENDS HERE 

BUFFER FIRST BYTE ADDRESS 

BUFFER SIZE, BYTES 

BUFFER INPUT BYTE POINTER 

BUFFER OUTPUT BYTE POINTER 

BUFFER READ COUNT (BYTES TO BE READ) 

BUFFER WRITE COUNT (BYTES WRITTEN) 

POINTER INTO USER DATA AREA 

COUNTER GOVERNING USER DATA AREA 



OUT OF SYSTEM 

INITIALIZATION I/O IN PROGRESS 

IN SYSTEM 

RELEASE I/O IN PROGRESS 



I DEVICE STATUS MASKS 

020000 R«^NDE = 1B2 I DEVICE REWINDING 
.EOT 
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LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 
0010 .MAIN 



AOUCT 00001« 


8/09 




BEGIN 000002 


3/16 




CF 00000! 


«/13 




CMDwO 000028 


8/ia 




CSL 0000412 


3/38 




CSO 00B0A3 


3/39 




CSP 000041 


3/37 




CTCB 000003 


3/17 




DADR 000015 


8/10 




DCC88 0A0080 


1/55 




DCCGN 000002 


1/42 




DCCNF 000010 


1/aa 




DCCPO 000001 


1/ai 




DCFFO 010000 


1/53 




OCFWD 004000 


1/52 




DCIDI 00000a 


1/U3 




DCKEY 0000a0 


I /at 




DCLAC 001000 


1/50 




DCLTU 020000 


l/5a 




DCNAF 000100 


1/47 




DCNT 000016 


8/11 




DCPCK 000a00 


1/49 




DCPFR 002000 


1/51 




DCRAT 000200 


1/48 




DCT8D 000017 


«/35 


8/12 


OCTCC 00002a 


a/ai 


8/16 


DCTCD 00000a 


a/07 




DCTCH 000003 


a/06 




DCTCT 00002a 


a/40 




DCTD2 000013 


a/26 




DCTDC 000015 


a/32 


8/10 


DCTDP 00001a 


a/31 


8/09 


DCTDT 000006 


4/09 




DCTEX 000005 


a/08 




DCTGN 000027 


a/a6 


8/19 


DCTIN 000010 


a/23 




DCTIS 000002 


a/05 




DCTLC 000025 


IX /HI 




DCTLK 000011 


a/2a 




DCTMS 000001 


a/0a 




DCTO 000020 


1/45 




DCTOC 000021 


a/37 


8/15 


DCTPR 000025 


a/a2 


8/17 


DCTQL 000013 


4/30 


8/08 


DCTQP 000020 


a/36 


8/14 


DCTQS 000016 


a/33 


8/1 1 


DCTSC 000026 


a/a5 


8/18 


DCTST 000007 


u/ll 




DCTSV 000000 


a/03 




DCTT1 B0B022 


4/38 




DCTT2 000023 


4/39 




DCTTO 000012 


4/25 




OISMI 000011 


3/26 




ERABT 000110 


7/32 




ERCLO 000106 


7/31 




ERDLE 000012 


7/08 




ERDNM 000036 


7/19 




EROTO 000101 


7/28 




EMEQF 000006 


7/07 
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LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 
0011 .MAIN 

ERFIL B08830 
ERFIU 000060 
ERFNM 000801 
ERFNO 800008 
ERFOP 000015 
ERIBS 8B0045 
ERICD 000003 
ERICM 000002 
ERLLI 003022 
ERMCA 000103 
ERMEM 080026 
ERNMC 000113 
ERNOT 000042 
ERPAR 00002a 
ERQTS 000050 
ERRTN 000023 
ERSEL 000031 
ERSIM 000047 
ERSPC 800027 
ERSRR 000104 
ERTID 000061 
ERTIM 000041 
ERUPT 000021 
ERXMT 000043 
ERXMZ 000115 

Fasw 000000 

FPFA 0000a5 

IAC0 000001 

I AC 1 000002 

IAC2 000003 

IAC3 00000a 

ICMSK 000005 

IOEND 000007 

IOFRP 000017 

IPCC 000000 

IRLOC 000006 

ISVLN 000007 

MKCAS 001777 

MKCDR 001777 

MKOKP 000617 

MKDPI 000217 

MKDPO 000217 6/11 6/12 6/13 

MKDSK 000717 

MKIPB 001717 

MKLPT 000010 

MKMCA 000017 6/08 6/09 6/11 

MKMTA 001777 

MKPLT 000017 

MKPTP 000007 

MKPTR 001737 

MKQTY 000003 

MKTTI 088003 6/05 6/06 6/07 

MKTTO 000003 

MODE 000032 

MTBZ 000401 

MTDCL 000033 

OA 000010 

OF 000000 



7/17 




7/26 




7/04 




7/03 




7/09 




7/23 




7/06 




7/05 




7/12 




7/29 




7/15 




7/33 




7/21 




7/1 a 




7/25 




7/13 




7/18 




7/2a 




7/16 




7/30 




7/27 




7/20 




7/11 




7/22 




7/3a 




1/24 




3/ttl 




3/0« 




3/05 




3/06 




3/07 




3/08 




3/24 




8/12 




3/03 




3/09 


3/10 


3/10 




6/19 




6/17 


6/18 


6/13 


6/lti 


6/12 




6/11 


6/12 


6/14 


6/15 


6/15 


6/16 


6/10 




6/08 


6/09 


6/18 


6/19 


6/09 




6/07 


6/08 


6/16 


6/17 


6/06 




6/05 


6/06 


6/04 


6/05 


8/23 


d/2U 


8/03 




8/24 




a/20 




4/12 





on 



LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 
mil .MAIN 

DPRET 00002a 8/16 

PANIC 000012 1/1% 

PFR 000030 8/20 8/22 

QCOND 00001 I 5/3i 

OLOST 000012 5/32 5/3« 

QMJM 000001 5/23 

OOCH 000010 5/30 

OPC 000^00 5/22 5/34 

OPRI 800005 5/27 

QRR 000006 5/28 

OSH 000003 5/25 

QSMS 00000a 5/26 

OTLN 000013 5/34 

OTLNK 000007 5/29 

OTOV 000002 5/24 

RB 000006 4/18 

RL 000003 a/15 

RLOC 009086 3/23 

RQCNT 000802 5/05 

RQLK 000000 5/03 

RQPTR 000001 5/0y 

RQST 000003 5/06 

RS 000002 a/ia 

RSCHD 00001a 3/30 

RTCTR 000031 8/22 8/23 

RWNDE 020000 8/50 

SCHED 00000a 3/20 

SCLLG 00020a 3/«5 

SCwPB 000377 8/0a 

SP 0000a0 3/36 

SSAC0 177776 1/30 1/31 

SSAC1 177777 1/29 1/30 

SSAC2 000000 1/28 1/29 

SSCRY 177775 1/31 1/32 

SSEAD 17777a 1/32 1/33 

SSLGT 177771 1/35 

SSOSP 177772 1/34 1/35 

SSRTN 177773 1/33 1/34 

TAC0 000001 2/36 

TAC1 000002 2/37 

TAC2 000003 2/38 

TAC3 00000a 2/39 

TELN 000011 2/44 

TEMP 000021 8/15 

TFP 000016 2/a9 

TID 000012 2/45 

TKLAD 000014 2/47 2/53 

TLINK 000013 3/29 

TLM 000015 2/53 

TLNB 000021 2/55 

TLNK 000007 2/42 5/29 

TPC 000000 2/35 2/53 2/55 

TPRST 000005 2/40 5/27 

TSL 000017 2/50 

TSO 000020 2/51 2/55 

TSP 000015 2/48 

TSYS 000006 2/41 

TTMP 000013 2/46 
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LICENSED MATERIAL - PROPERTY OF DATA GENERAL CORPORATION 
0013 .MAIN 



TUSP 


000018 


2/43 


UCTBF 


800003 


8/32 


UCT8I 


000005 


8/3a 


UCT80 


000006 


8/35 


UCT8R 


880007 


8/36 


UCTBS 


08000« 


8/33 


UCTB^ 


000010 


8/37 


UCTPO 


000000 


8/28 


UCTST 


000001 


8/29 


UCTUC 


000012 


8/39 


UCTUN 


000802 


8/30 


UCTUP 


00001 1 


8/38 


UNUM 


000813 


8/08 


UST 


000«80 


2/05 


USTAC 


000015 


2/19 


USTBR 


000012 


2/16 


USTCH 


000013 


2/17 


USTCS 


000010 


2/l« 


USTCT 


00001a 


2/18 


USTDA 


000006 


2/12 


USTEN 


000026 


2/30 


USTES 


000003 


2/09 


USTFC 


000016 


2/20 


USTHU 


000007 


2/13 


USTIN 


000017 


2/21 


USTIT 


00001 1 


2/15 


USTNA 


000026 


2/29 


USTNM 


00000a 


2/10 


USTOD 


000020 


2/22 


USTQS 


000025 


2/28 


USTP 


000012 


3/27 


USTPC 


000000 


2/06 


USTPQ 


00002a 


2/27 


USTSA 


000005 


2/11 


USTSQ 


000022 


2/25 


USTSS 


000002 


2/08 


USTSV 


000021 


2/23 


USTXQ 


000023 


2/26 


USTZM 


000001 


2/07 


WB 


000007 


a/19 


^L 


000005 


a/17 


WS 


00000a 


a/16 


XOPA 


0800a« 


3/a0 


.CMSK 


000010 


3/25 


.ISSU 


000027 


8/19 


.ST 


000026 


8/18 


.SYS. 


000005 


3/21 


.TSAV 


000015 


3/31 


.UCTX 


000025 


8/17 



3/28 



8/20 
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APPENDIX D 

RTOS ASSEMBLY LANGUAGE AND FORTRAN IV PROGRAMMING 

This appendix illustrates a sample real time assembly language program and de- 
scribes the procedures which must be followed in order to load and execute a 
FORTRAN IV program under die Real Time Operating System. 

Assembly Language Illustration 

The sample assembly language program, illustrated on die following pages, causes 
four user tasks to compete for the use of die system console, $ TTO. Each task 
types a unique message on channel zero. The sequence of events in die user 

pr .'grar. is a.-; f )!! ,\vs. 

First, all of the task calls which will be issued within die program are referenced 
externally by an . EXTN statement on line 6. Thus the following two task calls will 
be issued: . PRI and . TASK. If any task call were issued which was not externally 
referenced, die assembler would report an undefined symbol and the program would 

not be executable. System calls, on die odier hand, must not be externally refer- 
enced; the SOS and RDOS assemblers recognize each system call mnemonic and 
assemble die appropriate value for each mnemonic. Hie . TXTM i statement, 
line 7, packs all text strings from left to right; this is always required under RTOS 
and RDOS. 

Upon entry to TOT, die start of die program and only entry point declared by die 

. ENT statement (line 5), the teletype is opened on channel zero. 

Next, the program creates diree tasks and passes to each task a different displace- 
ment into the series of message byte pointers which will be used when the tasks 
output to the teletype. Note that each of the three tasks is created at priority 10g. 
When rescheduling occurs after each task call, die default task will continue to 
receive control since it is created at priority zero when die program is first 
started. After creating the diree tasks, die default task adjusts its priority to that 
of the other diree tasks so that it can compete for die teletype on an equal priority 
basis (line 30). 

Each of die four tasks now executes the code beginning on line 33, and outputs its 
message via system call .WRS . As each task issues die system call, it becomes 
suspended and control goes to die task scheduler, which raises the highest priority' 
ready task to the executing state. Each task remains suspended until its system call 
is completed. If the error return from any system or task call is taken, the program 
issues a "JMP." call, and the task is idled. 

The program .END statement has die argument "TOT". This will enable die RTOS 
initializer to transfer control directly to the program. 
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0001 TOT MACHO REV 


02 


il 






02 


;tvpeout test with multi 


2 2 




.TITL TOT 


?b 




.ENT TOT 


86 




,fcXTN .PRI »TASK 


07 800001 




.TXTM 1 


08 




,NREL 


09 






if eraea' e2iM3e 


TOT; 


IDA ,TTO 


11 0M0i»t2640i 




SUB 1 1 


12 i0002<M6017 




»S¥ST 


14 650WP3 » J 4Pk)g! 




.OPEN 


14 ft}0k$p4? 004431 




JSP ERR 


ID 






16 00005»02t}425 




LDA ?• PRIOR 


17 00006»024425 




lUA 1 N£WTASK 


18 000071152400 




SUB 2 2 


19 109010' 177777 




.TASK 


20 0001 1 >*J04424 




JSR ERR 


21 






22 00il2'l5l4«0 




INC 2 2 


24 00B14'vaMfc5Pl0» 




.TASK 


24 000141^04421 




JSR ERR 


25 






26 0Mlb» 1514K0 




INC 2 2 


27 id001b'tjgivjp!13' 




.TASK 


28 fc30K17 1004416 




JSR ERR 


29 






30 00020«177777 




.PRI 


31 0^21»l5l40p 




InC 2 2 


32 






33 ^«022'03442M 


l: 


LDA 3 .MESS 


34 «)?M23 < 15700M 




ADO 2 3 


35 (sP0?4i»j2i40ift 




LDA 003 


36 0^i32b« ? 4 4 w 7 




LUA 1 COUNT 


37 00026 «0«60 17 




.SYST 


38 00827 '«alb40pi 




.wRS fe> 


39 0003fei »Hi?U4tf5 




JSR ERR 


40 43003 1 * «^«frl7 7 i 




JHP L 


41 






42 00032' 4B0B 10 


PKIQRJ 


1M 


43 00033»^00R22» 


Nt^TASKJ i 



I4J0PS32 02/25/74 



44 0^034 »»i>W 10 COUNT: 8, 

45 

46 »fi0035 ' tf 0i 13 4 0P ERR: JhP . 

A7 

48 y0fe)3b»v30tf076» , .TTu: , + 1*2 

49 00037»^22124 .TXT /STTU/ 
5td ^52117 

51 aytipiapi 

52 

53 «0042«<JP!0t*43» .MESS: , + 1 

54 kJ0U43iv*0Mll6" HfcSS0*2 

55 0^04fl«M^^l j^" MtSSl*2 

56 k50045'0g«142" «tSS2*2 

57 fej p v) 4 b » -.o 00154 « m t S S 3 * 2 

5« 0P«)47 '^52101 MtSS0! ,TXT /TASH 1«15><12>/ 
59 <451513 

6fe5 ^20(461 



Sample Assembly Language Program 
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i'4S2 TOT 



€ O I" O £ 
« 6 4 i 2 



11 .7XT / 



MtSb2l ,TXT /TASK .-«:_><>> 



3 iflfc'toSo MS2t«U MtSiJ: ,TMT /TASK 4<15»<12»/ 

4 ^51513 

16 t1 » fc 4 1 2 

17 <?v»ttBwfc) 
Id 

19 ,hN& TOT 



y 


d 5 1 5 i 3 





^2^}Hb3 


1 


*)0b4 12 


2 


4 ij H W P 



Sample Assembly Language Program (Continued) 
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») p< i I (j I 












COUNT $»■. 






l/ib 


1/44 






t K ft *n v 


yi€ 35 




1/14 


1/2,0 


1/24 


J/26 


L P* 


V-S22 




1/34 


I /<4i(5 


I/4J 




Mt3S0 f-r 


tf ,4 4 / 




1/54 


l/5fl 






M t S d I £ 


a ■/, 5 4 




1/55 


2/P3 






MtSSi? »"/ 


-/ 6 I 




1/56 


2/iie> 






Mtssd m 


%*,tbb 




1/57 


2/13 






N fc * T A tf 


BSii 




1/17 


1/4,1 






PKluH P* 


m>i'i 




l/ib 


l/*2 






TUT fV 


ifi <6Wtf 




1/04 


i /PS 


1 / in 


2/iy 


.MESS fi? 


tfrf42» 




1/33 


1/54 






»P«1 Frf 


«M2'/» 


XN 


1 / tf b 


1/34 






.TASK <?■* 


M^ lfr ' 


XN 


t/0e 


1/19 


1/2.J 


1/27 


,TTO /M 


<)<l3b » 




i/im 


1/4U 







1/3* 



1/46 



Sample Assembly Language Program (Continued) 
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The relocatable binary produced by assembling this program can be loaded by 
either the stand-alone extended relocatable loader, the SOS loader, or the RDOS 
loader. In this Illustration we show the dialogue that ensues when the program is 
loaded by the stand-alone loader. 

After the loader is loaded, it self-starts and outputs the message "SAFE= . ** 
A carriage return response causes the top 200 locations to be saved, preserving 
the binary loader. After this, the star prompt is output. The program relocat- 
able binary (TOT), RTOSGEN module, and two RTOS libraries are then loaded. 
The RTOS module loaded with this program specifies 5 user tasks. Four user 
tasks are needed, and a system task is also required since use of the peripheral 
device is simultaneously requested by more than one user task. At the termination 
of loading, (*8), the initializer starting address, 376, is placed in the data switches. 
RESET, is then pressed, followed by START. The program is initialized and begins 
at entry TOT, outputting the task messages until STOP is pressed. 



SAFE 


= 


*2 TOT 


*2 RTOS 


*2 




*2 




*8TASK 


TASK 


2 


TASK 


3 


TASK 


4 


TASK 


1 


TASK 


2 


TASK 


3 


TASK 


h 


TASK 


1 


TASK 


2 


TASK 


3 


TASK 


4 


TASK 


1 


TASK 


2 


TASK 


3 


TASK 


4 


TASK 


i 


TASK 


2 


TASK 


3 


TASK 


a 


TASK 


1 


TASK 


2 


TASK 


3 



Load Dialogue and Program Output 
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Rea 1 Tire FORTRAN IV Programming 

Since RTOS is a compatible subset -: VX)S, RTOS will support a subset of 

DGC Real Time FORTRAN IV. To write a Real Time (RT) FORTRAN IV program 
ior use with RTOS, you may use either the RDOS FORTRAN IV compiler or the 
12K SOS FORTRAN IV compiler. Operating procedures for using these compilers 
are documented in the FORTM^IY_User^J^imal f 093-000053, Appendix D. 
The only restriction on use o c DGC RT FORTRAN IV under RTOS is that only those 
real time calls may be used which have corresponding system and task calls imple- 
mented in RTOS. 

Having produced one or more FORTRAN IV relocatable binaries, you use relocatable 
load procedures which are similar to those documented in Phis manual. Appendix B, 
for assembly language program binaries. The only addition to these procedures 
is the loading of the FORTRAN run time libraries, RTOSFMT. LB, FORT1. LB, 
FORT2. LB, FORTS. LB and the appropriate integer multiply /divide library. Thus 
the relocatable load sequence using either the stand-alone extended relocatable 
loader, the SOS relocatable loader, or the RDOS relocatable loader is as follows: 

1. FORTRAN relocatable binaries (the program proper) 

2. RTOS module produced by RTOSGEN. 

3. RTOSFMT. LB (the RTOS real time FORTRAN IV run time library). 

4. FORT1.LB 

5. FORT2. LB 

6. FORT3. LB 

7. An integer multiply /divide library 

8. RTOS 1. LB 

9. RTOS2. LB 

10. Other RTOS libraries as required (RTOS MTA. LB, RTOS CAS. LB, 
RTOS DSK. LB, or RTOS DKP. LB) 

After relocatable loading is complete, the FORTRAN program is started just as 
any other RTOS program is started. Details for executing an RTOS program are 

given in Appendix B, 
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APPENDIX E 
RTOS Inter-revision Incompatibilities 

1. Task call .REC now readies the highest priority task which has attempted to 
receive a common task message. 

2. The User Status Table has increased in size by two words, and TCBs are from 
1 to 5 words longer. 

3. Single task programs running in an ECLIPSE system load USP into AC3 upon 
return from system and task calls only if the task scheduler used is TMIN. 
Multitask ECLIPSE programs and single task programs using task scheduler 
BTMIN load CSP (the frame pointer) into AC3 upon return from system and task 
calls. 

4. Issuance of RDOS . SYSTM calls .GREAT, .GRAND, . CCOXT, .DELET, or 
.RENAME will cause the error return to be taken with error ERICM signaled 
("illegal system command"). Formerly these calls were executed as no-ops 
taking the normal return. 
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INDEX 



.ABORT 3-4, 6-5 
.AKILL 1-2, 3-4f* 

.APPEND 2-2f, 2-6f 

.ARDY 1-2, 3-5 

ASCII codes 2-14£ 

assembly language illustration D-iff 

.ASUSP 1-2, 3-5f 

asynchronous data communications mux (see QTY) 



BEGIN 6- If 



file and I/O system commands 2- Iff 

formatting a disk B- 1 
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